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INTRODUCTION 


sort/Utility will perform ait of the functions of 18's $DSURT 


program. Specifications may be given in free format» as in the 


SURT tanguage» or in the fixed field format of 8USURT. 


A selected subset of the input records may be processed. skecords 


of an input file may be included or exctuced from sort processing. 


depending on selected conditions. 


The format and contents of the output records may differ from the 
input appearance. Fields in a record may be rearranged or 
exctudede Characters may be forced into chosen” gositionse 
Seiected fields may be summed together to provide user processing 
during the sort rune | 


Different record formats may be specified within the same output 


file. Selected. criteria witt determine the arrangement and 
selection of fields in a record» and there may De numerous sets 
of criteria for one output file. : 


The order of the output file may be controlled by the user « 
Records may be sorted tn ascending or descending order. The 
norfrat collating sequence can be aitered to aliow the ordinal 


watue of a character to be controlled. 


In additions Sort/Utility has the ability to handie right or teft 
Signeds packed or unpacked fields. Character or numeric type 
data say be specified. Also» zore or digit portions of 


characters may be used. 
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This section. of ‘the document discusses the use of free format 


specificationse The free format syntax is given initially» with 
abbreviation definitions immediately foitlowing. Examples of each 
type of free format statement are also given. Those statements 
preceded by the symbol ">" are combined into a sample execution 
of SORT/UTILITY. . The equivalent fixed format syntax is given in 


the final example. 


The free format syntax has some extensions to the capabilities 
allowable in fixed format. Character constants are restricted 
onty by record size tin free format. The unsigned numeric» UN» 


packed data type exists only in free format. The ZIP» RESTAKT>» 
TIMING and STABLE options exist only in free format syntax. 


The TEACH option witli produce equivalent free format 


specifications to any given input specifications. It is designed 


to aid ir converting fixed format to free format syntax. 


There is. no specific restriction on the number of Record and 
Field type statements that may be specifiede The Limiting factor 
is the asount of dynamic memory available» as this is where the. 
intorgmation is stored. . #4 ~ | 


The entire input record size 1s used for interpreting free format 


inputs therefore» there must be no secuence numders in the input 
file specifications. —— 
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SPECIAL QPTIONS 
(May be specified only once) 
NOPRINT -don't prints must be the first token 


FILE IN {<name>} C<inepart>{<close-etypeein>J)e2ee name & attributes 
CUT <name>] C<outepart>{<closeetypeeout>]) 1°16 INs & 1 DUT 


COLLATE { FILE (<name>) } name of external coliate file 
< { € <coltlate constant> ) } collating sequence to be used 
Zip "<tit>*" Zipped at EOJ : — ) 


oP A ED we OD 


(May “be ‘specified only once» with the exception of "FIXED" and arm) 


rest of line contains a comment 


NOSORT - don't sort | 

ORUP CONTROL | don't keep contrcl fields in output records 
CONTROL <int> . maximum key field Length 
TEACH [C <name>) ] print the free format equivalent» and 

- on | | optionatly save on disk 

MECmory] <int> | dynamic memory to Je used in bytes 

SUMMARIZE ; add summarydata fietds of duplicate records 
RESTART C<int>] make restartable or restart job number <int> 
TAGSORT | 3 output is a tagfile of 8-digit packed Seg Vnak 
STABLE aa  dupticate records retain input order 

FIXED €<int>1] ** — Read atl or next <int> cards as fixed format 
SYNTAX | - check spec cards for syntax only 

TINING | = print VSURT timirg report 


«Aust be the only specification appearing on its input record. 


“LNCLUDE [C<disp>CEaQc«. 


“OVERFLOW CO ‘<const> (<const>1 9] 
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RECORE TYFE SPECIFICATIONS 


(Record selection and record type defirition) 


m<Lit>"(<Length>IL<type>1) CAND ]ess lee 
a<hex>a 1s  UAS COR*) 
ecnum># 

<disp> 


DELETE [NEQ: 
_ EL SS 
(GTR 

(LEQ 

{GEG 


ee ee ee ee | 


* Denotes default vatue 


FleLu SPECIFICATIONS 

(Output record description of each record type) 

KEY € <disp> <length> (<order>] (<type>] ) .«-. 

| Ax UAe | | 
FORCEKEY CREMAPS] € [C<disp> <const>] <const> {(<order>] (UA®] ) wee 
| | Atk CALPHA] 

(ZONE J 
COIGIT) 


DATA € <disp> <Lengt h> {<typer>] ) ee. 
FORCEDATA C <const> y: oes 


SUMMARYDATA C€ <disp> <tength> L<type>] {<overftow bengties ) wee 


UA® 


_#* Denotes default value 


<rsZz> 
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ABBREVIATIONS ANO EXPLANATIONS 


<inepart> = { <har> <rsz> {<rpb>] (CMULTI] } 
_ { DISK DEFAULT ly 
<out-part> = { <har> <rsz> [<rpb>] CMULTI) 
{ DISK DEFAULT YY 
<name> = a fite name according to MCP file naming conventions» 


except left and right parentheses must oe in quotes 


<disp> and <length> = tnteger oytes such that displacement 
| 7% plus tength is less than 8192 


<const> = "<Lit>" or @<hex>@ 
<collate constant> = "“<Llit>” or a€(<hexpair>) l<hexpair>(-<hexpair>]a 
<hexpair> = a pair of single <hex> characters 


<type> = ALPHA®» UA®» NUMERIC>s UN» SA» RSA» SN» %SNe ZUNE® or DIGIT: 


“<order> = ASCENDING or A» OESCENDING or D 


- 


<lit> = any EBCDIC characteris). Two adjacent quotes denote one quote. 


Yt 


<hex> any character(s) 0-9 and A-F 


<int> = any unsigned integer 
<num> = any signed integer 
= record size in bytes 


<har> = hardware: DISK ( <diskepart> )» PACK {¢ <diskepart> yr _ 
TAPE ( <tape-epart> ) J» CARD» CARUS or PRINTER 


<diskepart> = disk attributes? <records per area> (<number of areas>] 


<tapeepart> = tape attribute: OG» ODD» E» or EVENS implies 7 track 


_ <rpb> = records per block 
 €over flonu Length> = field length + overflow Length in bytes 


> <close.type.in> = PURGE 


éclosestypesout> = RELEASE (not disk) _ 
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EXAMPLES 

*>" The right arrow denotes statements used in the sample 


SORT job found in the EXAMPLE at the end of this section. 


Header Type Cards 


NOPRINT 


Requests that no tistine of the input cards be generated. If 
this tnstruction is lteft out a Listing witl de generated. If 
an error. is found the specification cards and errors are 
listed from that potnt on. 3 


NOSORT 
Po not sort the file» just create the output file as 
specified. If this tnstruction is teft oute a sort 15 
performed. 3 


DROP CONTROL | 
This requests that the key fietds» C(ieeer fields specified 
with the KEY and FORCEKEY statements)» be dropped from the 
Output recordse If this instruction is not given» the key 
fields will be inctuded in the output file records. 

>CUNTROL 6 
The maximum control field tength of ary record type is 
specified as 6 bytes. | | 

TEACH 


Print the free format equivalent of the input specifications. 


TEACH (<filenamei>) 


Print the free format equivatent cf the input specifications 
and save them on cisk as fite <filenamel>. 
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>MEMURY 12000 


The default memory. for the sort phase 15 8»000 dbytese Any 


integer specified» greater than 2000» will be used as the 
memory Si1zee In this instance» 12C00 bytes of memory will 
be used. a 


NE <integer> 


Same as MEMORY. 


>SUMHMARIZE 


Per form a sort summarizing the SUMMARYDATA fields. 
SUMMARYDATA fields occuring in records with duplicate Soper 


fields will be added wQecrnew? 


eee uine 


Restart information 1s kept. 


RESTART 2C80 


Restart the job with parent job number 2080- 


TAGSORT | 


Create a tag fite of relative record numbers» 4 bytes per 
recorde | | 7 | 


STABLE 


Z£1P 


Records with duplicate keys are output in the same order in 
which they were tnput. | 
"EX DMPALL® 


The command is ZIP"ped to the MCP at the end of the job. 
8efore fterainatings SORT/UTILITY witt ZIP "EX OMPALL™ string. 


FIXED 


The rest of the input is in fixed format. 


| | | 2-7 
BURROUGHS CORPORATION a COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP | B1800/81700 SORT/UTILITY 
SANTA BARBARA PLANT 7 PeS. 2222 2582 (C) 
FIXED 5_ 


The next five cards of input are ir tixed format. 


FILE IN <file namel> CTAPE {UDD) 10) IN (TAPE 10) IN exive name3> 
CTAPE 10 PURCE) OUT <filename4> CTAPE 10) 


specifies that there are three input files and one output 

file on tape» with record sizes of 1030 bytes. fhe third input 

file» <file name3>» is to be closed purge. The second input 

fide wilt be unlabeled. The first input files» <file namel>>» 
has odd parity implying a 7*track tape. 


FILE IN <file namei> CDISK (20) 80 HULTI PURGE 


One input file is srecified. It is on disk with a record 
size of 80 bytes. It tis a multiple pack file and the file is 
tc be closed purge. No output file attributes are specified. 


>FILE G“UT <file namel> (DISK OEFAULT) IN <file name2> CDISK DEFAULT) 


One input file on disk and one cutgut file on disk are 
specified. Their file attributes will default to the file 
header's attributes. : | 


FILE OUT <file namel> CDISK (50 75) BO) 


No input files are specifiede ne output file on disk with a 
record size of 80 bytes is specified. . There are 50 records 
per area with 4 maximum of 75 arease | | | ; 


| NOTES 


le Sceeitvins an output file to be closed curge is not 
valid. 


2- The order of the IN and OUT carts of tne FILE statement 
is-not restricted. : 


3e File names follow standard 61800/81700 file naming 
conventions» except that teft and right parenthesis must 
be in quotes. | 


4e The file statement is optional. File equates specified 
at execution time wili override file statement 
specifications. Missing attributes will be given SOL 
defaults untess the file its on disk. In this case the 
attributes will come from the disk file header. The SOL 
defaults will be taken from the FSP of a file with the 
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internal name of "DEFAULT". Attributes for output files 
described as DISK DEFAULT wit! come from the first input 
file if it resides on disk. Otherwise» attribute 
assignment 1s titdentical to that described abovee  (CSee 
File Attribute Assignment Precedence.) 


One to sixteen input files are ait owadte in SORT/UTILITY. 
In. ordee for SORT/UTILITY to recognize that a fite is to 


be included in a-SORT/UTILITY execution» either the name 
field» FPB.NAMES» or the hardware type fields FPB.HOWR, 
must be altered in the files corresponding FP. The 


internal fite names for these files are: INPUT» INPUT2> 


INPUT3..eeINPUT16. 


Non-disk input files are copied and locked on the system 
packe . | 
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Record Type Cards 


INCLUDE (1 "2") 


{If the vatue of the data begirning in byte position 1 of 
Length one byte and type unsigned alpha is equat to the 
constant "2" of the same type and tength » include this 
record in the sort. Therefore» the first record would be 
included and the second would not. 


INCLUOCE (1 LSS 40) 


If the value of the data beginning in byte position 1 with a 
length of one byte is less than the data beginning in byte 
position 40 with the same Lengths include this recerd in the 
sort. Both fields are defined to be unsigned alpha. Since 
neither a2" or a "3" is tess than "0" neither record would 
ge inciuded. : 


INCLUCE (5 NEQ "BB" 2) 


Sort all records that do not contain the constant "88" in 
byte position 5 for tength 2 where the constant and the 
comparison fieid are of type unsigred alpha (the default). 
Therefore» both records would be sorted. | 


INCLUDE €13 GTR 17 4 UN) 


If the value of the data beginning in digit position 13 of 
dength 2 bytes (4 digits) and type unsigned numeric is 
greater. than the value of the data beginning tin digit 
position 17 with the same length and types inctude this 
record tn the sorte. Therefore» since 200322 185 greater then 
acddla and 2000242 both records woutd be included in the sort. 


INCLUDE (52 EQL #-228# 4 RSN) 


Sort atl records containing “228 beginning in digit position 
51 for length 2 bytes (4 digits) where 7228 and the 
comparison fietd are of type right signed numeric» denoting 
packed specification. The number will be converted to a 
packed format.  f&oth records contain “228 in digit position 
51 in packed» right signed numeric format. Therefore» both 
records are included in the sort. Pte 
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>INCLUDE (30 LEQ #2452# 5 RSA) 


Sort atl records with a value tess than or equal to the 
number 2452 in byte position 3C for length 5 bytese - The 
constant 2452 and the comparison field are of type right 
Signed alphae denoting unpacked specification. The length is 
comptted in 6 Dit Dytese- The sign in this exanple is assumed 
to be positive and witt be added on the right. Both positive 
2452 and negative 2453 are less than or equal to positive 
2452 and both records will be included ir the sort. 7 


INCLUDE (51 GEQ@ 422802 4 RSN) AND C40 GEY "000001" 6 UA) 


If the value of the field beginning in position 51 of length 
2 bytes C4 digits) and type right signed numeric is greater 
than or equal to “228» and the vatue of the field beginning 
in position 40 of tength 6&6 Dytes and typre unsigned atpha is 
greater than or equat to the string "00CO01"» then inctude 
the record in the sort. Soth concitions must be satisfied to 
qualify a record for sorting. the constant a228@0a denotes 
the actual contents of the data field.j In this example» both 
records will be inctuded in the sort as they both satisfy the 
two conditions specified. | 


INCLUDE (30 EQL aF5F22 5 RSA) OR (35 EGL "LAST" 5) 


If the value of the field beginning in byte position 30. of 
fength 5 bytes and type signed alpha is equat to 52» 
Cright"justified» zero filled)» or if the value of the field 
beginning in byte position 35 of tength 5 bytes and type 
unsigned alpha is equai to “LAST "» Cleft-justified» blank 


filled)» then inctude the record in the sorte One of these 
two conditions must be satisfied if a4 record is to be 
inctuded in the sorte In this exampte» neither record wiil 


be included in the sort as neither record contains the value 
32 an positions 30 through 34» of the string “LAST " in 
positions 35 through 39. | 


NOTES: 

1. The word "AND" in this context denotes a continued 
condition. The word "OR" derctes a new condition. If 
ati conditions are true when ar "OR" is reached» the 


current record is assumed to betong to the current group. 
If a false condition occurs when an “AND"™ is reached» the 
"AND™ statements are: skipped and processing continues 
with the next “OK" statement. | “ _ | 


2e A time savings can be realized if INCLUDE statements can 
be organized into “groups”. A "group" consists of any 
consecutive INCLUDE statements that have like 
displacement» length» types» have a relation of equate 
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C"EQL")» and refer to a constant for factor72. They must 
not be connected by “AND"s. | | 


DELETE 


The format for DELETE is the same as for INCLUDE. 
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Field Iype Cards 


>KEY (35 5) 


KEY 


KEY 


KEY 


This key field begins in byte position 35 of the input file. 


It is 5 bytes in length and unsigned alpha typee It is to be 


sorted in ascending order. In this example the first record 
would sort before the second record since "FIRST™ is of tower 
vatue than “SECND”. 


(35 5 D) 


This key field begins in byte position 35 of the input file. 
It is of length 5 bytes and type unsiqned alpha. It is to be 
sorted in descending» OD» ordere In this example the second 
record would sort Oefore the first records» since "SECND" is 
of higher value than "FIRST". 


(30 5 A RSA) 


This key field begins in byte position 30 of the input file. 


It is of length 5 bytes and type right signed alpha. It is 
to be sorted in ascending» Ae ordere Therefore» the second 


record witl sort before the first record since 72453 is of 


Less value then 2452. 


C51 4 D RSN)D (35 5) 


There are two key fields. The first key begins in digit 


position 51 of the input fite. It is 2 bytes (4 digits) in 


length and of type right signed numeric. It 18s to be sorted 


an descending ordere The second key begins in byte position 


35 of the tnput filee | It ts of length 5 bytes and type 
unsigned alpha. It 15 to be sorted in ascending order. 


Therefore» Since the value of the field beginning in digit . 
position 51 is the same (7228) in both records» the second 


key then further determines the crder of the records. In 
this case the first recarc will sort first» as "FIRST" 3s of 
fess vatlue than “"SECND". | | 
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FORCE KEY statements always define one byte of the output record. 


—FORCEKEY CPAn) 


Uncondit tonalty» the character "A" is placed into the next 
byte position in the output record. It forms a new key field 
one byte in length» to be sorted in ascending order. 


>FURCEKEY (1 af 2a "A" ALPHA) 


If the character in byte position 1 of the input record is. 
equal to a "2" Cark2a)» place an “A" in the next byte position 
in the output record. Gtherwises since the key is sorted in 

ascending (default) order» aFFQ is placed in this position. 
A descending key would cause 200d to be supplied. Thuss the 

first record would cause an “A™ to be ptaced in its 
corresponding output record. The second record would cause 
aFFS3 to be entered. | | 


FORCEKEY (1 "2" "A" A ALPHA) REMAPS (2 "0" 3" A ZUNE) REMAPS 
C*c™ A) | 


In this case» each condition argplies to the same byte 
position in the output record which is the next position. If 
the character in byte position 1 of the input record is equal 
to "2" then place an "A" in the output record. If it is not 
equal to "2"%» and if the zone portion Cleftmost 4 bits) of 
the character in position 2 of the input record is equat to 
the zone portion of the character "OO" (CaFa)» place a "B" in 
this postition of the output record. If neither of these 
first conditions are trues ptace a "C" in the output record. 
Thus» the first record would cause an “A™ to be output and 
the second record would cause a “B" to be output. In every 
case the resulting key will be sorted in ascending order. | 


FORCEKEY (1 "2" "A" D) REMAPS (2 "07 "a" 0 DIGIT) (5 "A*™ "Z" UA) 


The first two conditions descrided in this “FORCEKEY™ 
Statement pertain to the same byte position in the output 
file record. The third conditior pertains to the next byte 
due to the lack of the word "REMAPS". If the character in 
byte position 1 of the input record is equal to a "2" then 
place an "A™ into the current byte position of the output 
record. If it its not a "*2"%- and if the digit portion 
Crightmost 4 bits) of the character itn position 2 of the 
input record is equal to the digit portion of the character 
"Oo" (203) place a "8" in this position of the output record. 
Utherwiser 20609 will be entered since the key is to be sorted 
in descending lee | 
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The third condition causes the current output record position 


to be updated by one byte. it states that if the character 


in byte position 5 of the input record is an “A™ place a “Z" 
in the new position of the input record. Qtherwise» 300232 is 
entered as described above. : 


Therefores the first record causes an “A™ and a "2" to de 
placed in its corresponding output record. The second record 
causes a “B™ and a “Z" to be outpute 


>FORCEKEY REMAPS (1 "2" "A" ALPHA) REMAPS (1 aF 03 aC22 ALPHA) 
REMAPS ("C™) | | | | 


The word “REMAPS" states that all force character conditions 
apply to the preceding specified key output positione 
Therefore» this statement must follow a "KEY* or a “FORCEKEY" 
Statement. The first condition states that if the character 
in byte position 1 cf the input file record is equal to’ "“2"%» — 
then “A™ is put in the Last byte position specified in the 


previous key statement. Condition two states that if the 


character beginning in digit position 1 of the input file 


record is equal to "0" (3F0a)» then a "3" (3022) is put in 


the same position in the output recorde The third condition 
states that if neither of the previous conditions is true» a 
*C" is placed in this same positicn of the output file 
record. This field witl be sorted in ascending order (the 
default). 3 | a : ; 
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DATA C1 6) 
Une output record field is described. The data field 


beginning in byte position 1 of the input record with tlength 
6 bytes and type unsigned alceha is to begin in the next 
position of the output record and given the same length and 
typee | | ; | 


>DATA (7 4 ZONE) 


Qne output record field is describeds- The data field 
beginning in byte position 7 of the input record with tength 
4 bytes and type ZONE ts to begin itn the next position of the 
output record and given the same length and type. The field 
is prefilled with @40a9%s and cnly the zones are movede 


DATA C49 2 SN) C11 14 DIGIT) 


Two output record fields are described here. The data field 
beginning in digit position 49 of the input record with 
length 1 byte (2 digits) and type signed numerics is to de 
placed in the neat byte of the output record and assigned a 
type of signed numerice The data field beginning in byte 
position 11 of the input record with tength 14 bytes and type 
digit» is to begin in the next position of the output record 
and given the same tength and type. The field is prefittled 
with @FOa's and only the digits are moved. | 
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>FURCEDATA ("4") 


The use of FORCEDATA implies that an unconditional force to 
the next output dyte position is to be _ performed. One 
unconditional force is specified. The constant "4" of type 
unsigned atpha is to be moved to the next output record byte 
position. | | | : | 


FORCECATA ("4") (CaC12) 


in this case» the constant "4", of type unsigned alphas is to. 
be claced in the next output reccrd byte position. The 
constant "A" CaC1la) of type unsigned alpha. is to be placed in 
the next output record byte position following the "4". 
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SUMNARYCATA C1 4) 


The field beginning in byte positton 1 of the input record» 
with tength 4 bytes and type Unsigned alpha is to be 
summarized» Cadded togetherds during a sSumhary sort. The 
maximus size attiowed for the output field is 4 bytes. There 
will be no dupticate keys in the output file. During SORTR> 
type of sort» the field witl not be summarized and wiitl thus 
be treated as a DATA specification. During an ADDRGOUT sort 

the field tis ignored. | | 


>SUMMARYDATA €13 4 SN) 


The fietd beginning in byte digit position 13 of the input 
records» with length 2 bytes (4 digits) and type signed 
numerics is to be summarized during a summary sort. The 
maxiaum size allowed for the output field is 2 bytes. There 
wilt be no duplicate keys in the output file. During a SORTR 
type of sorts» the field witl not be summarized and will thus 
be treated as a CATA specification. During an ADDROUT sort 
this field is ignored. 


SUMMARYCATA (51 4 SN 8) 


The field beginning in digit position 51 of the input record 
with tength 2 bytes (4 digits) and type signed numeric is to 
‘be susmarized during a Sumaary sorte The maximum s17Ze 
allowed for the output field is 4 bytes (8 digits). There 
wilt be no duplicate keys in the output fite . During a 
SORTR type of sorts» the field is'not summarized and wilt de 
treated as a DATA specification.  § During an ADDRUUT sort 
these fields are ignored. 


SUMMARYCATA (51 4 SN 8) (C1 4) 


Same as the above examples» though two SUMMARYDATA fietds are 
specified here. 


NOTES: | 


1. In a summary sort» the SUMMARYDATA fields must be in the 
same position for alt record types. The fields do not 
have to refer to the Same position in the input file. 


2e The first record type description containing summary 
specifications defines the sumeary format for all 
included records of any typee [t is recoamended that alt 
record type descriptions contain summary specifications 


Rae ranted no ee ETT 
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if one of them does. If a record type description does 
not contain summary specifications»s the data 
specification should align tne data for Summarization. 


SAP TS eg ETP ec ti af rete re le pr Ae Me emmy A eh 
eresaiopeh econ nheman enciareeren Sheer arin eae ie ee Te 
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UVERFLOXK 


If overflow occurs in any SUMMARYDATA field» the next byte 
position in the output record wiit contain an **". If no 
fields overflows a blank will be placed in this position. 


OVERFLOW C"0") 


If overflow occurs in any SUMMARYDATA field» the next byte 
position in the ocutput record will contain the constant "0". 

If no fields overftow> a blank witt be placed in this 
position. | 


>OVERFLOW (™*™ NT) 
If overflow occurs in any SUMMARYDATA field» the next byte 


position in the output record will contain an “**#". If no 
fields overflows "N" witt be placed in this pcsition. 


OVERFLOW CaD06a *N") 


If overftow occurs in any SUMMARYDATA field» the next byte 
position in the output record will contain the constant "0O"» 
Cie. 2069). If no fields overflow» “N" will be placed in 
this position. | ; 


NOTES: 


1. Onty one overflow indicator may be jatined for att record 
typese 
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EXAMPLE 
Input Data 
Lécebeee 5D ee oeee a0 lOsscuaewe eeolSecscesen ao O wsewee oO Dee we exceeds QDece eee wedS 
2 O44 &4AA THISIS THEF IRS TJ 0245 26 


F 2F OF 4F 4C101003 20001 € 3CAC9E2ZCIEZE 3CBCS5CEC 90 9EZE 3612280 0 05 0F OF 2F AF SF 2C6 


S60ciwweh0esdess be 5 wens se'ee 00 : ; 
IRest00g00g00012 | —— (first record) — 
C 90 9E2E 3F OF OF OF OF OF 1000003000F | 


303 2AA THISTS THES EC GN ODO 0245 L4 5 
FSF OF SF2CICLIOOS2OOOZESCACIEZC SEZESCECSECCSC SU6D5SC 42230 0040F OF 2F GF SD 3E2 


$Gseeew RO wed seas ’S ccensces50 | 
ECNOGQGOcqcdaOede.2 . (second record) 
C5C305C 4F OF OF OF OF OF 20000030010 


Sort/Utility Language 


FILE QUT <file wanes COESK DEFAULT) IN <fite name2> CDISK DEFAULT) 
MEMOKY 12000° 

CONTROL 6 
SUMMARIZE | 

INCLUDEC30 LEQ #24528 5 RSA) 

KEY €35 5) 

FORCEKEY REMAPS (1 *2" “A* ALPHA) REM APS C1 aF02 aC2a ALPHA) 

REMAPS ("CC") 

C1 aF2a "A" ALPHA) 

DATA (7 4 ZONE) 

FORCECDATA C"4") 

SUMMARYDATA (13 4 SN) 

OVERFLOW ("*" “N™) 


ma 


18666008 D0 605066 eolQwcaccccalSceavcaceelQoavncaccel Dencccesedsiice ee reens > 
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Fixed Forsrat Equivalent 


| 1 1 2 2 3 
QOOHSORTSRS 6A 14 


0101 U 30 34LEC02452 


O70FNC 35 59 


OB8OFFC. 12AX 
O90FFC | 108X 
LOOFFC Cx 
L1IOFFC 1i2ZA 
120F0Z 7 10 
L30FDV & 
14O0FSP 7 8 


 LSOFSV «N 


Resulting Output Records 


Lewcccce5 ene eo#eoe 808 LO cccrce 2el5 


FIRSAA ? N 
COC 9D 9E2C1C100300000F 4003205 


Leccwcne5 encceccs (els ataueae 


St Cnc 4 ON 
E2C5C3D5C3F F003 00000F 4003205 
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(first record) 


(second record) 
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FIXES FORMAT SPECIFICATIONS 


This section of the document discusses the various types of disk 
sort specifications that are aitowed ir fixed format. The column 
number appears at the teftwhand side of the page and the 
description of the function of that cotlugn fottlows. Where a 


fixed format entry is restricted in combination with other 


entries» a statement of the restrictions occurse The EXAMPLE at 
the end of Section 2 uses some fixed format specifications. 


There is no specific restriction on the number of Record and 
Field type statements that may be specified. The Limiting factor 
is the amount of dynamic memory available» as this 1s where the 
information is storede | 


pare at BOGE! pe oe 


eiCIL TAA eho Ment et ed a 


eden Aon Thr te vn ono teh 


—§ 35°39 | 0799999 1! Additionad storage size to execute i 


t { the sorte above 8K - 4 
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COLUMN SUMMARY - HEADER SPECIFICATIONS 
eet Ee Bm nan aw 2 awe we mam mm wm { 
ICCLUMNS! ENTRIES § EXPLANATION | i 
(See eee |e s< eee se (oS S47 Seer ee = see === — man ee <_ Mon On om on on an an ee ee ee { 
( 1°5 ! 00000 { Page and Line nunber i 
[mem en ee fo reese en [eee ce ne ce ns erence me mam anne mme weeennn| 
' 6 oH | Header line identification 1 
powcr ewe | ee em eeoe [ww ee aw cn emma emamamee RROD DOD annen Oe ( 
{ 7-i2 ¢ SORTA ' Addrout sort job | 
i Si ee ae ee ae en emi eee ine So ee Pas eee ee 
i 1 SORTR i Tag aron? sort job | i 
j prec cee mca | wawene _- <a ae ee om Oe on Senn nO ae mee we ee | 
1 1 SORTRS ¢ Summary tag _atong sort job | 1 
[SS eeee (Sess See es (2 sss = Se aS ee SS ee ee ee ee eS ae i 
1 13°17 1 #17511 { Longest cenneel field | 7 { 
fw to cone [vce er am ce [ee es em amen seam ana mae =ss=< a= s= al eee, 
i 18 1 oA | i Records sorted in ascending order i 
i {SSS SS 8 [SSeS Ss eS eS eS SS eS se es SSS Seen a ee es => 4 
i 1D | Records sorted in descending order 1 
aie eae ree = SSe = Ss s2 SSS Ses == <= = Sea SS Sa i 
119 ' le | ALL signs on are on teft of field i 
1 (Pe tee see fe ee ce em ere aman mem aman anam eom am name om | 
‘a i Blank 1 All signs are on right of field 1 
pe Sesess) = Se Sess S35 ( 2S s 22 SS4 Ss Sees ee sees === 2252S — Se = i 
!20 #4 Btank i First input file will not be 1 
4 ! i closed PURGE ee 
(Hees ene a aS Saae SS SoS eee aaa ee ene eae mia 
1 ie ae { First input file witl be closed { 
} en 2 > | PURGE a | an | 
(ses see [Sess seem |= ses == See See ena ee ghee eee ee etree mete eee een * 
1 21°25 1 Blank 1 Not used A. | | 
fesse 2¢ Leas SSS 6 52( Sees eS see eee s> <—-—— SSee a eS eee i 
I 26) i Blank 1 Use Standard collating sequence 1 
v . pete eer nan focnee ones em neme alates om re cm ae moman| 
i i 3s | Use adternate collating sequence 1 
[eSeee se [Ses etee eS] SsSes eH easton sees ee Sm Kee es eeeses | 
1 27 1 Blank 1 Not used : | { 
|r tn fn rnc n fern ne ener en cn en come en en cc en cee eannsna= | 
i 28 1 Blank i Keep control fields in output | i 
of | i | | records in tag atong sort jobs t 
1 ee or, 4 Drop control fields froa output i 
1 1 ! records in tag atong sort jobs | i 
need ala a a laa a to 
1 29°32 | 178191 4 Length of output records in tag i 
i | i along sort jobs | en | 
Lee eens [es eres eS | ons Sees eses = Sa ee 7S === ==: 
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Required and optional entries for header-type specifications are. 
discussed in the subsection belowe This discussion follows the 
format described in the first paragraph of this section. 


COLCS) 


1-2 


7-12 


13°17 


18 


19 


 HEADER-TYPE: FUNCTION AND DESCRIPTION 


Page Number: The first part of a five-digit page and. 


Line sequence number. If the sequerce nuaber s given are — 


in descending order» a warning will be issued. 


3 ~The second part of the fivetdigit sequence 
f the sequence nusbers given are in descending 
orders a warning will be issued. 


Line Type: Column 6 of the header iene: contains an “"H*" 


to een this line. 


Iype of Job The type of disk sort required is specified 


in these coluans. SORTA means addrout CTAGSORT) sort. 


SORTR means tagrmatong CDISK SORT) sort. SURTRS means a 
summary tag~ along COLSK SORT) sort. | : 


Eield Totat:. A description of the control field with the 


greatest tength. The length» in characters or bytes» 
gust not exceed Sil. It 15 determined by adding together 
the lengths of the control fields (N» OQ» or F in column 
7) for each type of record. When each type has been 
separately totaled» the largest (longest) is specified in 
these columns. The number must be right"justified in the 


 coluan field provided on the coding form. 


~Order: - Indicates the sequentiat order» ascendins or 


descending» ‘in which the records are to be sorted. The 


entry is either A for ascending or C for descending. 


Signed. Fields; §$ This cotugn ‘determines whether fields 


widi be right or teft signed. An bf in this cotumn 


specifies all signs will be on the teft of the fields if. 


the column is teft blank alt Tans wild be on the right 
of the field. | | 
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20 


21°25 


26° 


26° 


29-32, 
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bond REBECA CED CED PS OE oem a ae am am ah ame ad ——— <i a ED ED ED OD i> CED amb ainth am gan ene 


Fite Close: This ccluan is Left blank if the first input 
file is not tc be closed purge. A P indicates the first 
input file will be closed purge. 


flank: Not used for disk sort processing. 


Collating Sequence: This column is left blank if the 
standard EBCDIC collating sequence is desired. An S in 


—6tthis column indicates that an alternate collating 


sequences which must be specified through an ALTSEQ 
statements its to be uSsede | | 


If an alternate coilating sequence is desired» column 6 
in the record type specifications must not contain a P or 
a U which would indicate that the fields described are 


packed or unpacked. | 


Tag-atong Output: This column applies to tag-along 


output only. It indicates whether or not the program 
shoutd drop controt fields from the sorted output 
records. The cotusn is left biank if the control fields 
should not be dropped. An X in this column indicates 


that the control fields should be dropped. 


Control fields are normally dropped if opposite control 
fields or an alternate collating sequence are useds 
Furthermore» users must specify these control fields 
twice Conce as controt fietds and once as data fields) if 
opposite control fields or an aiternate coltating 
sequence are being used. Specifying the same field as a 


data field means that the program does not chance the 


field since data fields are not involved in the sorting 


process. 


Jaq Record Lengths: When a tagtalong sort 1s specified 
CSORTR or SORTRS)» this field 3s used to specify the. 


tength. of the output records written in the final sorted 


file. The tength specified defenas on whether the user 
has dropped control fields or note If control fields are 
dropped» tength includes only the data fields.. If they 
are not» the tength must be a sum cf Doth controt fields 
and data fieldse In either case» the sum of the control 
and the data fields must not exceed the maximum record 
fengths of 8151 bytese | 
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COLCS) ss HEADER-TYPE: EFUNCTIUN AND CESCRIPTION 


The number specified here will 


35°39 Sort Additionat Memory 
be added to 8K. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 


COLUMN SUMMARY = RECORD SPECIFICATION NS 


(COLUMNS! ENTRIES # EXPLANATION | i 
(ees ee a6 (SSeS e ee ee (Steer Se ere eS es Sees ee ere Sees Sees es] 
§ 1-5 1 00000 - § Page and tine nusber | 
( $§ 99999 { 3 1 
[ae eeeeee jw wees amen] eo ee ee ee me eee an ene Oe Oe ee ew awn eam awee | 
i 6 tl ~ 4 Inctude tine , i 
iy oo eae an ae em eae eee: fan em ana mena a en ap ee ae aged ere een ee ety 
| - 'o7 1 Omit tine i 
prercw ee oe ee ewe na | oem ee ee aw ee ew em wet ema aan an awamaw am | 
i7 | 1A AND tine | 1 
ee Co | mon nn en n-ne ---- = -- ---- -- --- --------- 
i i oO 1 OR Line i 
j j — 22 am om se | eee oe oe ewe ee se ema wae a mee Tee | 
i i Blank i First Line of a set of I or OU type I 
{ jw erect ew oe flow ewaewoewa a: sr. ee Se Pf eS ee ee PP he oO a a a ee | i 
4 i* i Comment line | { 
prc eer en | eee eee w om foe een ee ew ew ee ee wees oe ee ew ew ene — «a oe { 
i 8 Ic 1 Use both zone & digit chare portionsl 
i . [ees see eS | es esos == 5 — mo om 2 an ae oe em on ee ee ae ane on ae an ee on ee a j 
i. !Z ! Use only zone portion of i-char fld 1 
i jor we ew nwawjoaeome wm a an wm on oe cman ano ewes awa sn anaaas | 
( i oO 1 Use onty digit portion of characters! 
j fmm ce mre er rn en rn ne wren cm ee rene n- o-oo ao | 
i ! P § Stgned packed decimal data i 
j (eSeSesr == | So 8er Seo H eee Seas See eros =Ssses=] 
| i$ u § Signed unpacked decimal data i 
jw ewww eajoowe <2 = [222s SS ee eee ee kk ee ee ee Oe | onan am am |. 
§4gei2 1 178191 $f Factor-l - begtnning position i 
| i t (Cbtank if field Length one) | | 
ees ee Se) ee S22 <2 24 [2 eS SSS Se Se ee Se eee Se See eee eS eee =. | 
$1 13°16 | 178191 & Factor“1l ~ ending position 1 
| -+-----1--------- meron en nn nn nnn won nn oe ne == == ------ i 
§1i7"-18 | EQ i Factor~1 aust = factor-2 f 
4 i NE | Factor-1 must not = factor~2 1 
i [LT | Factor~1 must be < than factor-2 1 
{ | i GT i Factor-i must be > than factor-2 i 
f ! Le | Factor-1 must be < = to factor-2 i 
{ | GE 1 Factor71 must be > = to factor-2 i 
Tetatstatatated lntetetcetatetated latatetetetetatatatatetersteteteetantentenetetanatenatabeeetatne 
#=#19 ic i Factor"2 is a constant i 
{ (2s — oe oe jf weet ee 28 oe we ewes en ae ee ee em em ewe eam eee | 
of oF ! Factor-2 ~ another fietd in record 1 
ee (eS ae RS 2 ee ee eee Sees 2S ee ee a ee. 
1 20-23 1 178191 | Factor-2 ~ beginning position 1 
[Rese Ses |= Seohes Se (SSS essser sesso ee eee oes ee enaaS = see4 4 
1 24°27 1 1°8191 #t Factor-2 - engeud position | 
jeer seee [es SSS e= | Sos = — ww em ae ee ee Se ee ee ee wee oe we ee nw os oe a { 
1 20739 iCharacterl Factor-2 constant - any characters I 
J mee ewe | ee maaan | eam ee ce ww ee ew ee eee we we ween cece ww ow we | 
1 40°72 iCharacteri Comments © | _ t 
|------- |--------- [--------- on nn nn nn ne 22 nn = w= 2 = =| 
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COLCS2 RECORDTTYPES FUNCTION ANO DESCRIPTLON 
i-2 ‘Page Number s The first part of a fiverdigit page and 
dine sequence number. If the sequence numbers given are 


3°75 


in descending ordere a warning will be issued. 


Line Numbecs The second part of the five-digit sequence 
number . If the sequence numbers given are in descending 
orders a warning will be issued. 


Line Type: Cotumn 6 must contain either I for tnclude or 


for omit. The vatue I mésey be either include or 
includetall» depending on whether or not columns 77°39 
Crecord description) are blank. If record=type Lines are 
used» the specifications ust contain at teast one 
~tnetude or tncetude alt> otherwise» no records wilt be 
sorted. a 
Inctude: specifies which records are to be included in 


the sort» according to the particuiar records fields that 
are described in coluans 7739. 


Include~ati: tells the sort program to sort ait records 
that have not been described by any preceding include or 
omit lines. Only one includematl can be used per jobs 


and it must De the last record=type tine for that job. 


Cait: identifies what records are not ta bde_ sorted. 


Omit tines are not required and are normalty followed by 


an includewall tine which tells the program to sort att 
records not. described Dy omit lines. 


Setss There are two types of sets: include sets and 
omit sets. An tnclude set identifies one or more record 
types that should be inctuded in the sort. An omit set 
identifies one or more record types that shoutd be 


omitted from the sort. Sorting Dy sets presumes that att 


the records have at feast one distinguishing 
characteristic in commone The rutes for sorting by sets 


are as follows: 


1. All include sets must end with a field-description 
line. . 


2- Omit sets never have field-descrirtion lines. 
3e- Every omit set must de followed by an include set. 
4e The last set must be an inctude set. 


NOTE: A time savings can be realized if Include 
Statements can be organized into "groups". <A “group” 
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RECORD-TYPE: FUNCTION AND DESCRIPTION 


cous) 


consists of any consecutive Include statesents that 
have like displacements» Length» type» have a relation 
of equat CEQ)» and refer to a constant for factor72. 
They must not be joined Dy "ANOD"s. 


Continuation or Comment: Colusn 7 indicates the tine's 
relationship tec the preceding iine for the specification 
of include and omit sets or indicates that this is a 
comment tine. Column 7 should contain one of the 
fotlowing entries: 


Elank The cotuan is left blank if it is the first of a 
get of include (CI) or omit (0) tines or 1s a 
single include or omit ltne.e 


A Stands for AND in retation to the previous include 
or omit line. 


G Stands for OR in relation to the previous include 
or omit Line» ieee» a different record type than 
the previous Line» but the control field 
specifications are the same for both. 


* Identities this line as a comment line which does 
not affect the sort in any way. The line ts 
altiowed purely for documentation. Comments are 
printed onty if column 27 of the header Line 
contains a zero or a lank. . 


Interpretation: Specifies whether the data in the 
specified field is to be compared as character values or 


as numeric values during compare operationse. When the 


field contains alphanumeric data» Cs» Zs» or D must be 


Specifiede § When the field cortains signed numeric data» 


P or U aust be specifiede If an aiternate collating 
sequence is used» a packed or unpacked field may not be 
used in an include or omit record-type specificatton. 
Suamaries of this information are presented in tables 3.3 
and 3e4e 
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kee REEA REE REEERREEEAKEERKEEKR AREER RE REE 
* Entry * Compare Operation * 
* (cot 8) « | te 


RaReKKEaKAKEKKEERKKERKRKKKKEKEKKKKKKKKREKE 


oo | te a : t 
| * Cc #* Use both zone and digit t 
| * * portion of the characters * 
RHaEAERKAAEKEKAKRKKAKKKKAaKEKEKKEAKAKAKKEKEREKARKRKAARK SE 
| « a t te | | te 
| | | * N * Unsigned packed numeric * 
* * data. fe 
| RAKEKKKKEEREKEAKAEEKEEEKARKAEAKKEKEKAKKKRAAKAEKEKAKEK & 
& | & : &« 
a | & Z € Use onty the zone portion * 
= © * of the characters 
. KKEKAKARKEAAKKEKAKEAKEKKEKKKEKKKEKRKKKKKKKAKRKAK & 
& . * | & 
* Oo * Use only digit portion t 
a * of the characters te 
ARAEKKEKEKAEEEEKAREKKEKEEKEKKEEKEKEKKEKKKK KEL 
- * | he os ae 
* P * Numeric data 1s packed  & 
a  « (see note below). * 
MRE EEEKEREERAEKAKAKEEKEEKEKKKEKKKKKKE 
‘® * x 
* U * Numeric data is unpacked * 
& * (see note below) & 


RERKEEKRAAEKAERKKAKAKKEAKKKKEKKKEKKAKKEKAKKAKKKER 


Tabte 3.3 Interpretation Entries 


Note: U and P are not allowed when an alternate coltating 
sequence has been specified in conjunction with include 
or omit record type statements. | 


ie 
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ERHEKEAKAKKEKKKEKAKKKE REAKKEKKEKKAKEKKEEKAKAKKKARKAKKEKKEKE KAKA KE KKKEKAKEK 
Format of «* Entry Definition = Considerations t 
*«Nuweric Data * Ccol 8) * sl | 
RARE AEAARAEAKRAKEKEAAKEEKEKEAEAREKEAHREAREEKAREARERAEKKKKEK KK HK KE KEKAEKKKAKEKKKAK 
° ‘ & & & & 
* Unsigned * D * Number does not * Absolute values of* 
* te * have a signe BSoth * the numbers are & 
* & * the zone and digit* used.e~ Att zone & 
* * portions are * portions are * 
* | ff * stored. | * stored as aFa te 
HREKEARHKERKEREEREKKKAE REKKRAKAEAEKRHKEKEKAEKAARAEKEKREREEEKAKEKEKREKAKAKKEKEK 
= | & fe t | & 
ie & Packed: Nuaber if 

* *  * always carries a * Sign control 

* * & signe Onty the * (see note below) 

* & P * digit portiors are 

* * * storede * 

& & * 

«Signed REECE KAKKEEKKEKAAEAKEAKAKHKEKKKEKKKKREKKEKKKKEK 

- & t & 

* & * Unpacked: Nuasber * 

te tf * always carries a * Sign control 

* e * signe Both the * (see note betow) 

* * U * zone and the digit* 

* & * portions are * 

* = « stored. * 

- & & & 

RARER ARAERAKEEKEREAREKERAEKEKEEKEAAKEKAEKEAAAEKEKKEKAKKEKREKE k&k&kk kk kkakkkhztk 


toh he ee Re 


Tabte 3.4 Format of Numeric Data 


Notes: 


le The sitgn controis the comparison. For el Soa =s is 
less than zero and +5 is more than 7“6- 


2 Before comparing numeric datae disk sort converts any 
leading blanks to zerose 
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COLCS) 


9-16 


17-18 


19 


Factor~1 Location: Columns 9712 identify where the 
factor-1 field begins in the reccrde- §Coluans 13716 
identify where it endse 


Note: Factorel1 is the data being compared in the 
record "type statements. fFactor-2 its the data Factor-1 1s 


compared against. 


The length of the field cannot exceed the length of the 
record being sorted. For examples an paneer een record 
may. have a maximum factor~1 entry of 80- 


Entries are right-justified in coluans 9°12 and 13716 for 
beginning and ending cotuans» respectively. When a 
length of one character is involved» columns 97-12 are 
left blank and the singte record pose sae is entered tn 
the field 13-16. | 


Relation: The relationship between factor-1 and factor-2. 
must be specified and must be one of the standard 
relationat operators tisted below. If an alternate 
collating sequence is used» both factor~1 and factor~2 
are modified before the comparison is made. 


The retationship must be one of the following: 


EQ (CFactor-l must be equal to factor~2-) 

NE (fFactor-1 is not equal to factor~2.) 

LT (Factor-l is less than factor-2.) 

GT (Factor-1 is greater than factor-2.) 

Le (Factor-1l is less than or equai to factor~2.) 

GE (Factor-i is greater than or equal to factor 72.) 


Fietd or Constant: Identifies whether factor-~2>» the 
field factor71 is to be compared to» is a constant or a 


fietd. When aC is entereds cofdugns 20739 are used to 
define the constante When an F is entered» coluans 20727 
are used to identify the location of the factor-2 fietd 
arEean the record. , 
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20727 


20°35 


40772 


Factor"2 Field: Factor-2 must oe the same Length as. 


factor-1 and sust be tocated within the sage record. 
Similar to factor-1 declarations» the starting posittion 
of the field is declared (rightrjustified) in columns 
20°23 °#£x®and the ending position is declared 
Cright-justified) in columns 24°27. Oner~character fields 
are described with an entry in the ending~column half of 
the field onty. | oe 


Factor-2 Constant: When factor"2 is a constant» the 
constant is entered in cotumns 207392 | #$Note that the 
length of the constant must be the same as the length of 
factor"l» for a vaiid comparisone The constant may be 
declared as any vatid EBCDIC character» or string of 
characterse Aitphabetic or alphanugeric constants are 
left-justified within the field. | 


Numeric constants must de right-justified within the 
field Length specified itn factor71l (Cwithin twice the 


field fLength if factor-1 is a packed number)» with 
leading zeros or blanks. For example» a S5“position 


factor-1 that ais being compared to the numeric constant 
"123" must be declared as "00123" or ™ 123" #=x.Since’ the 
two fields wust be the same length. In this exaaple»s 


"123" is right"justified in a S*position field. 


Signed constants: If factor-l is a packed number» the 
last digit in the constant must de its sign (+t or ~). If 
factor-1 is an unpacked negative numbers the last 
character in the constant must be one that indicates both 
the numeric value of the last digit and the negative sign 
for the entire constant- See Tadie 3.4.56 


Comments: These columns | are available for any comments 


that the user wishes to make. Comments have no effect on 


the program’s operations 
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(| ww ew cme wee awe mata aw anata aman ewe ew ewen ee ewaooew= | 
i Coding Negative Unpacked Constants | 1 
f Te et ee we enw em ecwmomasom ma ae Oe hee ee Eee ee eS oe ee @ a oe a a ae aD a ou | 


i «If tast digit 1 Character t Hexadecimal 1 
i inoconstant ts 1! used i Equivalent i 
: ( 1 { 


i O- i } { a00a d 


4 1 4 J i aD1a { 


qo 2 _ { IK 1 2022 { 


‘ 3 | Lo i ap 3a 


i 4 4 ! aaa ! 


i 5. i N i aD5a i 


1 6 q oe a06a 
J oe ee ee cme ew em emee | ao en em ewe ene | ow ee ee ew em ee ewe= | 


i ( ! P i a0 fa i 


laletatatatedatetatatate coee-- J-oe-- ahetatatated leteatate salaeateiataiatatel. 
8 | ' Q 308 1 
teletatatetatatatatatetatatatetated Relatetatetateiate a atatel Retetetatatatatatetetetatatanel | 
5 4 R 2094 


Table 3.4.5 Coding Negative Unpacked Constants 
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COLUMN SUMMARY = FIELD SPECIFICATIUNS 
mere r en] eo enn en cones | mn cone se enon ecnaaan Sk —_ a a mo | 
ICOLUMNS! CONTENTS 1 EXPLANATION i 
ae [Sse ee | See Sere ss ee (oe ee nee ee aS eae eS — aa me a a a oe ne | 
ine | ys i 1°5 ' 00002 - | Page and Line nuaber f 
5 | | 1 99999 | { 
freer ecewe| oe ewmewesewoee | oe 08 oe ee ee em ew en anata enema waa | 
{ 6 iF [ Field specification line a 
jrcwrawaa| ce emanwaamewce a [one nenmamansaew am oma Oe Oe Ow ew ee ee 1 
i 7 1 oN j Nor mal control fietid | 
i per eee ce ce ewe | on en we ce we ae wren on ne ee ee ene een nm | 
1 i o- 1 Opposite control field i 
i [omen ce teens | ce ce ce em en en ew en cn we ence meme amaman | 
{ yor. Forced controt fietd 7 a { 
| [eS Sees~ sere s ( Se sess er = <= ose" = S58 2S ae a Ss 1 
! io | -f Data field : ; 1 
i SSS = Sess e0' = (| 9S eae SSS ee eS ae ee eK ee ee eee eee | 
1 is _ 4 Summary data field i 
: i pees see sso S| SSS SS SSS Sees SS es SS eee = lle i 
| i 1 * | 1 Comment Line 1 
| (asses (sees Saw ee | ae a a 66S See SS aS eS ee ee eee i 
| 1@ ip i Signed packed neei wat data : 
1 iu 7 1 Stgned unpacked decimal data i 
i for ose seen  Rolealtetetiaatastnatentateatatedetettes omen en cee nw esa one | 
{ ic 3 1 Field uses zone & digit chars 1 
i [ees Ss sess e= [Ses 2 S3 SS 46s SSeS Ss ee ethane eee eee | 
i i 2 ! Uses zone portion of iwchar fietdl 
i a a aa Sk a a a a an a aad ee 
i i oO 1 Uses digit portton of characters 1! 
i pote ee ee cm ewe [ce teen ee em es sees ewe ew ew aman aw amae | 
i iv | {i Forces data character into field 1 
{Ss eese= [tere es ees [ss eres = See ee eS SS a SS of 
§ 97-12 § 178191 -§ Starting position of field 1 
4 i 7" i Colank if fieitd length one) y 
: : . ee eS Se oe ee J we ce ee ne amen eee et Oe aN mee eM eee i 
_ ; | § 13°16 1 176191 i End position of field in record 1 
| : [eee esse |S ae ee eee eo af aT ew? ee, eee, oe ee ee ee er ae es eer eee eye |) = | 
4 17 iAny nonbdtlank I Forced field conditional char 1 
(ese e4eK | eS e= se" SSS eee ee se ae SS eae as eee Se ea ae eS | 
1 18 dAny nonbtank! Forced field substitute char 4 
bs eee see| Se eee eS S224 2 (Sess eee Se ees ea = = 9s 222 = i i 
119 i Blank i Forced field not a continuation | 
i i | i of the prerer 0g Cane i 
i SSS Se Sees 4S 6 [ee Se ee Se Se SF SS 22222 Re See eee a aS { 
|  § Not blank 4 Forced field continuation i 
[rte eee] eee en ee Smee s | en S82 ee 68 ae ee we ee ee oe ee ee eee ese sean | 
é f 20722 | 17-999  ¢ Summary overflon field tength i 
aa aa at a aa a ca ac a 
§ 23°39 i Not used i Not used | : 
fret eros jw eee ee we ewe | oe on ae ee ee eet a2 ee Of eB OF Oe AB ee em ee oe | 
§ 40°72 tAny text & Comments - characters i 
(Sass232 [S22 es s-sS> a a ag 


fabte 3:5 Sueudry Oe Eeeta Descripc ren speci ieatiens 


ret 
Sed 
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Output records from a disk sort are formatted Carranged) 
according to the instructions of the sort*s field-description 
specifications. This subsection defines the proper syntax for 
those fields. 


1-2 Page Number: The first part of a fiverdigit page and 
| 7 line sequence number. If the sequence numbers given are 
in déscending orders a warning will be tssued. 


375 Line Number: The second part of the fiverdigit sequence 
number. If the sequence numbers given are in descending 
order» a warning will be issued. 


6 Line Type: Cotumn 6 of the field Line contains a 

preprinted F to identify this tine. Addrout sorts 

CSORTA) use field lines describing controt specifications 

only. The field tines used by tagvralong sorts CSORTR) 

and summary tag-ratong sorts CSURTRS) may be either 

control fields Cused to sort the records) or actuat data 

fields. In addition» field lines for summary tag-along 

sorts describe the fields that the program is expected to 
suamarize. | 


7 Field Iype or Comments: Entries in this colusgn are 
chosen from the tabte below: | 


er a a ee ee 


MRE RARREREREREREK KER EE MEEEEKREREEREEERAERKEKKREAKEKKKEKKEKEKEKEKE 
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ERE REE RER EE EKER EERRERKKEKAKEKEKRAREAKKKKKEKEAKEK KEE EKER 


* Entry * Specifies: & 
* (col 7) * : | # 
KE ARAARAARKEAEARKKAKRKEKEKRKKKKKKKKKEKEKEKAEKKEKEKKAKRKE KK KA KRKEAKKRAKKRKEKKKE 

as ft 


* This is a data field. It is used for tagzalong * 
D * CSORTR»e SORTS) sorts onty.~ If avd entry is used * 
* during an addrout sorts it is treated as a t 
* comment line. | Py 
* & 


© RAREREREEA EERE EE REKKEKERERERAEEAKAAEAEEAEE AREER EERE 
te. | | . 
 * A normal controt field. Sort this field so that. 
N * data from the field is in the sequence specified 
tt tn column 18 of the header tine. 
* | | 
ARERR RAERAERKKKEKAKREKRKKKKAKKEA RAKE KERKEKERAEKERERKEKEEE 


» 


* This is an opposite control field. Sort this 

* field so that the data from the field is in the 
* sequence opposite that specified in cotuagn 18 

* of the header line. | ; 


BRRARARAKEAKKAAEKRAEKKEKEKAERAKEAEKEKAKEKEEAAKEEKAEKEEKEKKREKKAKEKEKKKKRKAKREKK 
re . 


* This is a forced control field which specifies 
F * that the control fietd should be modified 


* according to the entries in columns 9719. 
ft 


ye ee ee PP bee ee ee UU 


& * 

& $ * This 1s @ summary data fteld. It ts used for 

* * summary tag~walong sorts CSORTRS) only. If an S$ 

* * is entered during an addrout sort» the tine is | 

& * treated like a comment line. If an S ts entered 
* * during a tagwalong sorts» the fields are treated 

* * as norpal data fields. 

a : an | 

REKKAREKREREREEEAKAK EK REE ERERERER RARER EKER RARER EEKRE EEREER 
* , & | & 
te * * This is a comment Line. _¢* 
x *x & 


REKKARAEKKEKEKEKAEKEAREKAEKRAAKEKEKEEKEKKAKKKEKAKKHKKA KAKA KKkkEAKKKKKKKKEK 


Table 3.6. Interpretation Entries 


BURROUGHS CORPORATION 


COMPUTER SYSTEMS GROUP 


SANTA BARBARA PLANT 


cous. FIELD-IYPE: 
7 Data Fields: C0 
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EUNCILON AND ‘DESCRIPTION 


in Column 7). Data fields apply to 


tag-along CSGRTRe SORTRS) sorts only. They are fields 
that users wish to have inctuded in the output records. 
Controt field lines must be declared before data fields 


within include sets. 


When a fite has 


more than one type of record» the 


following conditions appty: 


w The number of data fields do not have to be the same 
for atl record types. 


* The total tengths of all the data fields do not have 


to be the same for 


ali record typeSe . Disk sort 


places btanks to the right of shorter data fields so 
that alt total lengths are equal. 


Control Fields: CN» 


QO» or F tn column 7). These fields 


determine the sorted sequence of the output file. They 
apply to adit three types of sortss SORTR»e SORTRS» SORTA. 


Opposite Control Fietds: indicates that the control 
field its to be sorted in opposite order’ from that 
specified in the header line. For example» if the header 


line has established 


ascending order as the order for 


this field» aQ specifies descending for this control 


field. 


If the fite contains different record types» all of which 


have an opposite 


control field tn the same record 


positions the column 8 entry must be one of the 
following: att Os» ali Cs» alt Zs» or any combination of 
Cs and ZSs- Any other combinations produce unpredictable 
resuitse : : | 7 

Packed or Unpacked Controt Fields: Controt fields are 
changed while building the work record to atftow proper 
sorting of signed fields. Therefore» control § fietd 


inforsation must be dropped by entering an X in cotumn 28 


of the header tine. 


If users wish to maintain” the 


ortiginat control field data in the output records they 
aust repeat the control information as.a data field. 


Forced Controt Fields: 


(F in coluen 7). These fields 


are igptlemented in three modes: Condittonals Force~ail>» 


and Unconditicnal. 


BURROUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA BARBARA PLANT 


cOLCS) 
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Forced control fietds affect the work and output records 
only. The proper syntax for these sodes is found in the 
discussion of columns 17719 below» and in Appendix 8B» 
FORCED-FIELD SORTING PROCEDURES. | 


Forced Controt Fields are defined according to_ the 
following conventions: | | 


* Oniy one character may be contained in a forced 
| control fietd. 


te The force may be either conditional or unconditionat. 


* A forcetmalt tine must be preceded by a conditional 
force line. 


When a ftite has more than one type of record: 


* The number of control fields does not have to be the 


same for ait record types~- 


* The totat lengths of the control fields do not have 


to be the same for all reccrd types. 


When records with duplicate controt fields Crecords 
with all the control fields equal) are sorted» the 


order in which they are output cannot be guaranteed 


to be the same as the order tin which they appear in 
the input file» i-e.» the sort is not stable. 


Summary Data Fields: An S tin colugn 7 defines a summary 
data fietd. Summary data fields may be defined for att 
three types of sorts» but the fields are added together 
Csummarized) onty in summary sorts. In tagvatong sorts 
CSORTR)» summary fields are treated as normat data 


fields. In addrout sorts (SORTA)» summary fields are 


treated a5 cogments- 


In a summary sort» the summary data fietds tin the work 
and output records for individual record types must 
always be in the same position. The fields do not have 
to be in the same position in the tnput records. | | 


The first include set that contains Summary 
specifications defines the summary format for ail 
inctuded records of any set. It is recommended that all 


include sets contain summary specifications if one of. 


aac 
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them does. If an include set does not contain summary 


spectficationss the data specification should align the 
data for summarization. 


8 Intecoretation: Specifies whether the data in- the 
specified field is to be compared as character values or 
as hexadeciaat vatues during compare operationse When 
the field contains alphanumeric datas C» Ze» or D must be 
specifiede When the fietd contains signed numeric data» 
P or U must be specified. If an atternate collating 
sequence is used»s a packed or unpacked factor7i aay not 
be used. When the field contains a Ve a data character 
1s forced into the data field. A summary of this 
information is presented in table 3.4. 
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CREREREEEERKERERREEAEEHEEREREREEEERRER EE 


* Entry ft Compare Operation f 
* (col 8B) * & 
AEREHERE REA RERERE RR EREREE EERE NER EEE EERE 
& & * 
« $¢€ * Use both zone and digit t 
t * portions of the characters * 
RAREAREARKKEEEAEEEAEKKAEKKKKKKEKEKKEEKAKEAKEKKE & 
x * & 
* N  « Unsigned packed numeric * 
ae * data * 
RAERKEAKEKEKEAKKEKAKKEKEKREKRAEEKEAEEKEEKREEREKER EK 
& & & 
* Z *« Use only the zone portions * 
* | * of the characters te 
KAEKKAERAAREAEKAEAKAKREKKEKAEREKEKEKEEKKAKKKEKKEKAKE 
& * | . * 
& D * Use onty digit portions & 
* 7 * of the characters an * 
RaEKRKEKKKKEKAEKKKKE KEKE KAKKKREKEKKRKEKKKEKEKSE 
. - ~*~ | _ . t 
* P * Numeric data is packed « 
* € (see note below). t 
ARAKKAKKEKKEKRAREEKERKKKKKAKKKRKKKAEKKAKEKEKE 
& & * 
* U  & Numeric data is unpacked * 
* | * (see note below). | * 
TOC SPESTSRRESAESASELSAASESCR SESE ERSRESRALESAE SSE SS : 
x * & 
* v * Force one data character & 
* ; * into the data fietd. * 


eaARRAKRARAKAREKAEREAEAAREKRKKEAKEKEKKKEKKKKEER 
 YTable 307 Interpretation Entries 
Note? Uand P are not atltowed wher an alternate collating 


sequence has been Specified CS in cotumn 26 of the header 
record). 


iol 
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Table 3-8 shows possible combinations of coluans / and 6. 


RKAEKKKKKKKEEKEREKEKKEKKE 


& Cote 7 & Col. 8 * 


EKRKEAKKAKKKKEKKRAKKKKKEKKEK 


* Noor 0 ze #=6C * 
& * Z * 
* * D t 
ee ’-<— P fe 
& * U * 
ARREEHEKKKEKKEREKEKREREKELK 
* F * Cci) * 
* ZO1) *) 
* *#  OC1) * 
RAREKAEKEKRKAEKRERAKAKKAKRKK 
& D f C * 
t Z f 
x t D * 
* & P tt 
t & U t 
ae te y & 
KREKKKEKKAKKEKAKEKEKARERE 
* 5 & Cc & 
* & Z & 
& & D & 
t * Pp * 
& fe ~Y * 
x 3 ¥ x 
* 


KKKEKKAKKKAKKKKKREKE KEK KE 


(1) For an unconditional force and a force~all line» column 8 
must contain aC. | , 


Jabte 3.8 Possible Coabinations of Colusns 778. 
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COLSS) 


9-16 


17 


18 


19 


FIELO-TYPE:  EUNCTION AND DESCRIPTION 


Eijeld Location: Identifies the input record positions 
that contain the record fields. Columns 9712 Cfrom) 
specify the starting position of a fietids cotusns 137-16 
the ending position of the fietd. The order in which the 
fields are described determines the precedence of the 
controt fields and the format of the output record. 


Entries must be right*justified»s ending in coluans 12 and 
16 respectively.  Onewcharacter fields require a 
right“justified entry in columns 13°16 only. 


Conditionally Eorced Characters: An entry in this coluan 
1s only required when a conditional force is desired (see 
column 7 or Appendix 8B for further discussion o f 
Forced~Fieid Sorting procedures). The entry tells the 
disk sort program which character in the control fietd is 


to be replaced by the character in cotuan 18. 


If a control fietd contains one of several characters 
that are to be replaced with separate forced characters» 
an entry in cotuan 19 must be contained in all the 
forced"fietd lines except the first. See coluan 19 for 
instruct ionse " @ oe 4 | 


Forced Character: This cotuan contains the forced 


character when a forced controt“fietd sort has been 
specified> otherwise it is blank. The character either 

replaces the control field character specified in column 
17 or it adds a new character to the control field for 
sorted output record(s) onlye Note that all the 
restrictions for a valid forced-controt-field sort Csee 


discussion on column 7) apply to this entry. 


Note: See Appendix 8B for § “further discussion on 


 Forced"Field Sorting Procedures. 


Forced Field: Multiple Replacements: ‘If a control field 
in an input record may contain any one of several 


characters and forced~character repiacements for more 


than one character are desired» a separate line is used 
to def ine each possibie character and the forced 
character with which it is to be replaced. Note that 
colusn 19 must be biank for the first field statement in 


sehr orn cs 
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(COLCS) FIELO“TYPES FUNCTION AND CESCRIPIION 


an include set. 


Coding? Multiple Replacement 
1. Define the control field in coluans 13716. 


2e Enter the first character to be replaced in column 
17. 


3e Enter the character which replaces it in columns 18. ~ 


&. Enter the next character to be replaced in coluan 17 
of the next Line. 


Se Enter the character which replaces it in <conuen 18 of 
the same line. 


6- Enter any character except Diank (C2402) in cotuan 19 
of the same line. This specification informs disk 
sort that the line refers to the same control field 
in the work record as the creceding line. 


“- Repeat steps 49 5» and 6 for any other characters to 
be replaced. | | 


Note: if colugn 19 were left blanks» each Line would 
define a new position in the work and output recordse 


Note: if the input records are Deing sorted in 
ascending order CA in coltcan 18 of the header line)» 
a aFFQis placed into the work record before any 
characters are forced. If descending order» a 32002 

as placed into the work record before any characters 
are forced. Therefores if a force character is not 
founds the hexadecimal characters CQFFQ2 or 2002) are 
feft unchanged in the work record. | 


Qverflow Field Length Entry: These coluanns are used 
oniy by a Summary Tag-Alongs SORTKS» sort to eliminate 
the possibility of an overflow condition Dy increasing 
the Length of the summary data field to attow for any 
anticipated overflone. 


The aver flow fietd length entry should reflect the sum of 
the summary data fietd tength and_ the anticipated 
overflow length. The entry must De right~justiftied tn 
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COLC3) 


23°25 


40°72 


coluan 22 and cannot exceed the maxieaum field tengthe 
Cotuans 20722 are ignored by a FSZ and an FSV since these 
fields can be only one byte Longe 


Blank: These columns are not used and should be left 


blank. 


Comments: These columns are available for any comments 
that the user wishes to makee Corgments have no effect on 
the program's operatione 
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MESSAGES 


This section covers error and warning messages generated by 
SORT/UTILITY. Error messages will halt further processing of 
SORT/UTILITYs warning messages are informational onty- 


Both error and warning wessages wilt be printed on SURT/UTILITY's 
output CLINE) fite. If the NOPRINT option has been specified» a 


Listing wilt be generated only if there are errors or warnings. 


If prograa switch 1 is set to 1 (SW1=1)» any occurring errors or 
warnings wiil be printed to an ERROR.LINE file» along with the 
associated text. | - | : 


Error and warning messages associated with a specific line will. | 
immediately foltow that line. Messages associated with a record 
types such as *INCLUDE/DELETE MISSING FROM PREVIOUS RECORD TYPE» 
fotlow that record type description. The remaining error or 


Warning messages refer to alt the input specifications» such as 


the warning “DIFFERENT CONTROL FIELD LENGTHS: ACTUAL <INTi> 
SPECIFIED <INT2>". These messages wilf occur at the end of the 


SORT/UTILITY Listing. 


ERROR MESSAGES 


"A DISPLACEMENT EXCEECS MAX INPUT RECORD SIZE OF <INTi> BYTES™ 


A displacement specified in a fixed or free format statement 
is targer than the gaxitamum record size of the specified tnput 
fides (denoted here by <INTIi>). | 


"BLOCKING IS NOT AN EVEN MULTIPLE" 
In this free format FILE statement» the number of records per 


area specified for the current file is not a multipie of the 
number of records per block specified. | 


“CONFLICTING BLOCKING" 


In this free format FILE statement» the records per area 
specified ts greater than or equat to the specified records 
per Diock. | 
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"CONFLICTING LENGTHS" 


In the current fixed format INCLUDE statement» the fietd 
length described in coluans 9°16 conflicts with the field 
length described in coluans 20°27. | 


"CONFLACTING SPECIFICATIONS* 


Header statements or free format FILE statements contain one 
of the following errors: 
- conflicting types of sorts have deen Specified, such as 
TAGSORT and SUMMARIZE 7 
- DISK DEFAULT has been specified in the FILE statement 
atong with a records per area part 


"CONTROL FIELD LENGTH I[S GREATER THAN 511 BYTES" 


The maxigum key Length of 511 bytes has been exceeded tn one 
of the foltowing ways: | 
~ The sum of the control fields of the previous record type 
exceeds 511 bytes 
- The number indicated as the maximum key size in the fixed 
format header card» coluans 13717» or the free format CONTROL 
statement is greater than 511 


"CONTROL FIELDS MUST PRECEDE DATA" 


Control fields have been found following data fietds within 
the current record typee | 


"DATA NAME INVALID IN THIS CONTEXT* 


A word composed of alphabetic characters was found outside of 
Statement contexte It 1s not a reserved worde This error 
will occur only once untit a reserved word is found»s 
pigeweran statement context is to be resumede 


“DIRECTION OF REMAPPED KEY IS NOT THE SAME* 
In ‘the cierent free format FURCEKEY staterent» the directions 


ascending or descending» is not the same as that of the’ key 
or FORCEKEY it remaps. 
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"DISK DEFAULT ONLY*™ 

Only the attributes of a disk file can be defaulted ina free 
format FILE statement. 

“DR OP CONTROL REDUNDANT DURING TAGSORT - IGNORED* 

Both TAGSORT and OROP CONTROL imply that key fields be 
exctuded from output fite records. DROP CONTROL wilt be 
programatically ignored if both are specified. 

"EXTRA FILE IN OR QUT" 
in the current free format FILE statement» more than 16 input 
files or one output file have been specified. | 

“EXTRA LEFT PARENTHESIS" 

In the current free format FILE statement» an extra teft 

parenthesis has been found. — 
eee REMAPS MUST loa KEY OR PE RENE YT 
Onty a KEY CFM or FQ) or FORCEKEY (FF) field can be remapped 
Canything but blank in column 19) by another FORCEKEY field. 
"INCLUDE/DELETE MISSING FROM PREVIOUS RECORD TYPE" 
Previous data or controt fields were described before the 
current INCLUDE or DELETE statement» and they were not 
preceeded by an INCLUDE or DELETE statesent. : 
"INCLUDE MUST FOLLOW DELETE™* | 
The Last DELETE statement of a record type must be fotlowed 
by an [INCLUDE statement. 
"INCORRECT RECORD SIZE" 
In the free format FILE statements» the record size specified 


for the current file is described to be zero or greater than 
B191 bytes. 
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PINPUT RECORO IS DEFINED TO BE GREATER THAN 8191 BYTES* 


The displacements» fdengths» or displacements plus tengths 
given in the record and field type statements describe input 
wecord positions greater than 8191 bytes. 


PINVALID CARO TYPE" 
Coiuan 6 of the current fixed format card does not contain an 
FH» "1"%»5 "0", OR “F™ nor is this an "ALTSEQ" card. 
*TAVALIC COLLATE STATEMENT ™ 
Processing of the current free format COLLATE statement has 
been terminated due to one of the fottowing errors: 
= more than 256 items have been specified to be cottated 
= could not find ending quote or a~sign of a literal 
~ delimiter other than a quote or a-sign found 
= missing teft parenthesis 
"INVALID CONSTANT" 
The numeric constant of the current free format statement 
contains non-numeric integers. 
"INVALIC CONTROL STATEMENT” 
No number has been given to Peneese ae the maximum sum of the 
controt fields. 
"INVALID CATA STATEMENT" 
Processing of the current free format DATA statement has been 
terminated due to one of the following errors: 
- the statement is incompletes Length or displacement missing 
= the displacement or length given is zerc 
“INVALID DATA TYPE" 


Cotusn 68 of the current fixed format record or field type 
Statement does not contain a "Z"%» "D*¥» "P"» "C™» "U" or “V". 


BURROUGHS CORPORATION | 
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SANTA GAREBARA PLANT 


"INVALIC CEVICE™ 


The free format FILE statement has one oo 
errors: 


f 


the fotlowing 


- device type is either missing or not equal to one of the 
followtng: DISK» PACK» CARD» CARDS» TAPE or PRINTER 
- the current input file's device type has been specified 


as PRINTER 


“INVALID DISPLACEMENT" 


A displacement was expected» but one 
conditions was found: 
- the item 15 non“numer ic 
“ the item ts zerc 
- gin fixed format only: | | 
~ an ending displacement is blank 


of 


the following 


- an ending displacement is of smatter value than a 


Starting displacement 


"INVALIO OROP CONTROL STATEMENT” 

The expected word “CONTROL” is missing. 
"INVALIC FIELC TYPE" 

In the current fixed format Field statement» 


not contain a "0"%» "N"» "F"™» "DO" or "5S". 


PINVALIO FILE NAME* 


column 7? 4=does 


The file name in the current free format File statement was 


invalid for one of the following reasons: 


™ file name found does not follicw standard 81800/81700 file 


naming conventions 


lett and right parentheses pust be in quotes 


PINVALID FILE STATEMENT" 


Processing of the FILE statement has been terminated due_ to 
explanation of 


its incoapleteness (see syntax for 
“nontoptional parareters). | 
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PINVALID FIXEO STATEMENT™ | 


A non“numeric token was found following the word “FIXED*. 
Onty the word "FIXED" or “FIXED” followed by a number should 
be present on this record. 


"INVALID FORCEDATA STATEMENT® 


Processing of the current free forgat FORCEDATA statement has 
been terminated due to one of the following reasons: 

= expected left parenthesis is missing 

= constant not found 


"INVALIC FORCEKEY STATEMENT" 


Processing of the current free format FURCEKEY statement aes 
been terminated due to one of the following reasons: 

- expected left parenthesis is fissing 

~ displacement siven is zero 

- displacesgent is given Dut not followed Dy two constants 


PINVALIC INCLUDE/DELETE STATEMENT" 


Processing of the current free forsaat INCLUDE/DELETE 
statement has been terminated due to one of the following 
reasons: | | . 4 | | 
- an “AND®™ or "OR" was SPeeureed but no further specifications 
followed | | 
= expected teft parenthesis iS missing | 
= two displacements» or one displacement and one selenite’: 
constant are sissing 
non“numeric token found when expected numeric disptacement. 
~ *PELETE" is specified followed by no further specifications 
- displacerzent or length given is zerc 


“INVALIC KEY STATENENT® 


Processing of the current free forgsat KEY stategent has been 
terginated due to one of the fotlfowing reasons: 7 
“~ expected left parenthesis is missing 
- displacement. or length given is zerc 
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INVALID LENGTH” 


In a free format KEY» DATA or SUMMARYDATA statement» a tength 
was expected where a nonnumeric token was found. 


“INVALIC LITERAL" 


If the error message is referring to a free format COLLATE 
statement» then the error is due to one of the following: 
- duplicate specification of coltated characters 
- hex pair of integers required to specify a characters» or 
position was not found 
- dash or teft parenthesis followed by another dash or left 
parenthesis 
- dash» left parenthesis» or vatid hexadecimal character 
expected but not found 
=“ beginning value of range is equal to ending value 


If the error message is referring to a free format 
INCLUDE/DELETE stateaent» then the error 18s due to the 
foilowing: 

= ending delimiter of constant not found on current record. 


If the error message is referring to a free format FORCEKEY» 
FORCEDATA or OVERFLOW statements» the error is due to one of 
the following: 

= delisiter other than quote or @-sign found 

- ending delimiter of constant not found on current record 

“- constant specified describes sore than one bDyte of data 


"INVALIC MEMORY STATEMENT" 


No number or a number tess than 8000 was given ict towtnd the 
word “MEMORY™ or “ME. 


*INVALIC OVERFLOW STATEMENT* 


Processing of the current free format OVERFLOW statement has 
 peen terminated. No token or a token other than quote or 
a"sign was found foliowing a left parenthesis. 


TENN ALTY PARITY PART" 
Processing of the FILE statement iat been terminated. No 


token or a token other than “E™» “EVEN"» "0" or “ODD™ was 
found following a left parenthesis. | 
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"INVALID RECORDS PER BLOCK" 
Processing of the FILE stateaent has been terminated. The 
number of records per block was specified as zero. 
"INVALIC RELATION” 


In. the current fixed format record type statement» coluans 
17-18 do not contain "EQ*>» “"NE"» “LT"» "GT"» "LE" GR "GE". 


"INVALIC RELATION FOR ZONE" 


In the current fixed format Record type statement» colunan 8 
contains a “Z"» indicating a zore type fields therefore» 
coluans 17718 may onty contain "EQ" or "“NE™s indicating 
“equal to" or “not equat to” retationse 


po ““INVALIC SUMMARYOATA STATEMENT" 


Processing of the current SUMMARYDATA statement has been 
terminated due to one of the following reasons: 

“= expected left parenthesis 18 gissing 

- displacement or length are not given 

~- displacement or length are zero 


"INVALIC TYPE COMBINATION" 


In the current fixed format Field Type statement one of the 
fotlowing errors occur: 

= coluan 7 contains “N™ or "QO" and column 8 contains a "V"™ 

- column 7 contains an “F™ and cofuagn 6 contains “"P"» "U™ or "V¥" 


"INVALID ZIP STATEMENT ™ 
Peeceas tne of itive ZIP statement has been terminated due to 


one of the following reasons? 


- delimiting beginning quote not found 
™ gmessage is tonger than 256 characters 


in 
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"MINIMUM TAPE RECORD SIZE ALLOWASLE IS 6 BYTES" 


In the free format FILE statement» the hardware type has been 


specified as tape and the specified record size is tess than 
B bytes. 


"MASSING ENDING QUOTE" 


Ending quote was not found before the end of the current 
recorde In the case of a ZIP statements» an ending quote was 
not found before the end of the CARDS file. 


"MISSING LEFT PARENTHESIS” 


In the current free format Record or Fieid type statement» a 
left parenthesis was expected and rot found. 


“MISSING RECORD SIZE" 


In. the free. format FILE statement» a numeric token 
representing record size was expected folloning hardware type. 
but not found. Record size must be given unless DISK DEFAULT 
1S specified. | | | 


“MISSING RECORDS PER AREA PART* 


In the free format FILE statement» DISK or PACK was specified 
as the hardware type foitowed by a tleft parenthesis» 
indicating a records per area and optionally a nuarber of 
areas specification tc follow. Either no token or a 
non “numeric token was found. 


"MISSING RIGHT PARENTHESIS" 
A right parenthesis was expected to terminate the previous 
Statement. No tokens were found and atk other specifications 
| for ie statement were optional. 
"MULTIPLE FILES ON DISK ONLY" | 
In the free format FILE statement» HWULTI was specified with 


other than a DISK or PACK hardware type. Multicmpack files 
are only defined for DISK or PACK. 
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"MUST HAVE CONTROL FIELDS" 


No valid KEY C"FN" of "FO" Cots  €77) of FORCEKEY CFF" Col. 
6-7) type statements have been found in the previous record 
typee | 


®NUST HAVE DATA FIELDS WHEN DROPPING CONTROL" 


DROP CONTROL has been specified in the header cards. No 
valid DATA or FORCEDATA C"0" Cot. 7) or SUMMARYDATA C(*S*% 
Col. 7) fietds have been defined in the previous record 


type. 


"NEEDS AT LEAST <X> BITS MORE DYNAMIC MEMORY®™ 


"NO 


"NU 


"NO 


"NG 


Memory requirements for buffers» keys» etc (see DYNAMIC 
MEMCRY USAGE» page D71) exceed the defauit vatue of 32000 
DIts. . te | | 


CLOSE RELEASE OF DISK FILES" 


in the free format FILE statement» RELEASE was specified with 
a hardware type of DISK or PACK.e. Ciose release is oanly 


defined for nonwdisk files. 


INPUT FILE SPECIFIED" 

The FPB values for hardware type and file name have not been 
altered» with a FILE statement or fite equates» from their 
initial values of SPO and nudis respectively» in any of the 
input file FPB*S. 

INPUT SPECIFICATIONS*™ 


No valid statements were found in the CARDS file. 


MORE HEADER CARDS ALLOWED® 


All header type statements must occur before att record or 
field type statements in the CARDS file. 
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"NO NAME® 


The word FILE was specified in the COLLATE statement 
indicating a fttie woutd follow. No tokens or a teft 
parenthesis were founds however. 7 


"NOT A NUMBER" 


If the error refers to a free format statement: 
- A numeric token was expected following the words “CONTROL > 
"MEMORY" or “ME" Dut none was found. 


If the error refers to a fixed format statement: 
- A numeric token was expected but not found in the header 
card in cotumns 13°17» indicating maxiaum control key lengths 
or columns 29°32» indicating maximum output record length. 
"NOT HEXADECIMAL VALUE" 
A hexadecimal number was expected» delimited by a@-signs. 


Integers found were other than "012345678 SA8CDEF™. 


"NUMBER IS TOO BIG" 


The number found is larger than. expected. The Limits used 
are as follows: | : | 
- gaximum number of areas allowable is 105 
- all numbers must be less than @ integers long» except. 
constants 


"ONE FIXED HEADER CARD" 


Mere than one fixed header card» “H" in column 6» has been 
founde 


"QUTPUT RECORD I5 DEFINED TO BE GREATER THAN 8191 BYTES” 


The gaximum output record tength of #8191 bytes -has’ been 
~~ exceeded in one of the following ways: | | 
™ the nuaber indicated as the maximum output record size 
in the fixed format header cards coluan 29-32» is greater 
than 8191 bytes 
- the sum of the data and control fietd type cards Cdata 
only if drop control has been specified) of the previous 
record type exceeds 8191 bytes 


pS oe ES eae ee ee ee eee mation ian AS. oa 


go raphe tan se eg raraTn 
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"OVERFLOW INDICATORS ARE NOT THE SAME" 


In a Summary sort» only one OVERFLOK indicator may be 
described. It must be the same (same output record posttions | 
same literals) every time it is defined. 


"PREVIOUS INCLUDE ALL ENCOUNTERED" 


Qnce an INCLUDE ALL has been descrided» no other INCLUVE or 
DELETE statements (record type statements) are allowable. 


"PURGE INPUT FILES ONLY" 


PURGE has been specified as the out put file*s close type. 
Close purge may onty be performed on an input file. 


"RELEASE ON OUTPUT ONLY" 


RELEASE has been specified as an input file's close type. 
Close release may onty be performed on the output file. 


“SIGN NOT ALLOWED" 


The constant detimited by number signs (#)» or specified in 
fixed format contains the sign symbol» # or ~» Dut has a type 
of ALPHA» ZONE» DIGIT» UA» C» Z or D Cunsigned type). 


"SPECIFIED TWICE® | 
The onty type of statements that say be specified tore than 


once ares FIXED» INCLUDE» OELETEs KEY» FORCEKEYs DATA>s 
FORCECATAs SUMMARYDATA and OVERFLOk. | 


“TAGSORT INVALID FOR MULTIPLE FILE INPUT" 


The word "“TAGSORT"» in free format» or "SORTA"» in fixed 
format» has been specified with more than one input file. 
Relative record pointers would not be meaningful. 


4-13 


BURROUGHS CORPORATION | | | COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP 7 81800/81700 SORT/UTILITY 
SANTA BARBARA PLANT | PeSe 2222 2582 (C) 


"UNLABELEC DISK FILE™ 


No file name was given» either with a file statement or file 
equates to the input disk file being defined. 
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WARNING MESSAGES 


"ALTERNATE COLLATING SEQUENCE ASSUMED" 


In the fixed foruzat header card» cotusn 26 does not contain 
an *“S" or a blank. An atternate collating sequence wilt be 
expected. : 


"CHARACTER CONSTANT LENGTH TRUNCATED TO 20 CHARACTERS" 


In the current fixed format INCLUDE/DELETE statements» the 

fength specified tn columns 9716 is greater than 20 bytes and 
a constant has been specified. The length wiit be truncated 
to 20 bytes. : 


"CONFLICTING OVERFLOW FIELDS - FORCEDATA CFDV) ASSUMED" 


In a sugemary sort» only one OVERFLOW indicator may be 
described. The OVERFLOW indicator tast descrided differed» 
either in output record position or indicated literal, from 
the first OVERFLOW indicator described in the input 
specifications. This fietd will be aitered to describe a 
FORCEDATA fietd. 7 | 7 


"CONSTANT AND FIELD LENGTHS OIFFER™ 
| In the current free format INCLUDE or CELETE statement» the 
length of the constant specified is different than the given 
field tength. | 
"CONSTANT FROM FREE FORMAT INPUT WILL EE TRUNCATED" 


An INCLUDE or DELETE statement is deing interpreted to free 


format syntax aque to the TEACH command. It contains a 
constant greater than 20 characters in tength. This 
indicates the statement was specified in free format 


originatly.- The constant wilt be truncated to 20 characters. 
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"DIFFERENT CONTRCL FIELO LENGTHS: ACTUAL <INTI> SPECIFIED <INT2>" 


The control field tength specified in the fixed or free 
format header statements differs from the actuat maximum sun 
of the control fields described for any record type. The 
vatues in bytes for these figures are given in this warning 
messager Cdenoted here by <INTI> ard <INT2>). 


“DIFFERENT OUTPUT RECORD SIZES? ACTUAL <INT1> SPECIFIED <INT2>" 


The output record size specified in the fixed foraat header 
statement or the free format FILE statenent» differs from the 
actual maximum output record size described by the field type 
Statements of each record type. The vatues in bytes for 
these figures are given in the warning Rea eeoee Cdenoted here 
by <INT1> and <IWT2>). | 


“DRGP CONTROL ASSUMED - COLUMN 28 NOT X" 


In the fixed format header card» column 28 does not contain 
an "X* or a blank. Control fields witt be dropped from the 
output file. 


"INPUT FILE <FILE NAME> MISSING" 


An open was attempted on the disk file specified in this 
statesente (denoted here as <FILE NAME>)» but the file was 
not found on disk. 


"INVALIO CONTINUATION - GR ASSUMED" 


In the current fixed format INCLUDE or DELETE statement ("I" 
or "0" Cotugn 6)» coturmn 7 does not contain either an “"A™»s 
"O">» “"«" or a Blank. The current INCLUDE/DELETE statement 
wilt be "GR*ed with the previous INCLUDE/CELETE. 7 | 


"INVALID FACTOR-2 TYPE - CONSTANT ASSUMED" 


In the current fixed format INCLUDE/DELETE statement» column 
1$ does not contain a "“C*™ or “F" indicating constant or 
field» respectively. It wild be assused that FACTOR-2 wilt 
be described with a constant. ‘ 
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“INVALIO OVERFLOW LENGTH" 


In the current fixed or free format summary statement» the 
overflow length Given is tess than’ the field tlength > 
indicated. The field tength wilt) be used as the output 
lencth for this field. | a 


"INVALIC SORT TYPE - ASSUMED TO 8E SORTR™ 


In the fixed format header cards columns 7-12 do not contain 
either *SORTR™> “SORTRS™ or “SORTA"™ Left justified. "SORTK"» 
a tag-along sort» is assumed. 3 


"MORE THAN ONE OVERFLOW FIELD CFSV) - FORCEDATA CFOV) ASSUMED” 
More than one overflow field (C"FSV" coiuan 6-8) has been 


described in the current record type description. [ft witt be 
altered to describe a FORCEDATA C"™FD¥™ column 678) field. 


"NG VALIC ALTSEQ STATEMENTS FOUND" 


The fixed format header card contained an "S" in colugn 26 
indicating an atternate coitate statement is to be specified. 
No fixed or free format cotlate statement was founde 


"NUMBER OF SUMMARY FIELDS IS INCONSISTENT* 


A different number of SUMMARYDATA fields ("FS" column 677) 
has been described in the current record type than «as 
defined in the first record type description contatning 
SUMMARYDATA or OVERFLOW fields C*FSV" column 6-8). 


“RECORD SIZE ALTERED DUE TO TAGSORT - 4 BYTES" 


The maximum sum of the key and data fields (data only if drop 
control is specified) is not equal to 4 oytes. The output 
record size will be 4 bytes and will contain the retative 
record pointers to the sorted file. 


"SEQUENCE NUMBERS ARE OUT OF ORDER" 
The current fixed format sequence number given in columns 1°5 


is less than or equal to the previous sequence number-  £The 
order of the input cards will not be altered. 
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"SHOULD DROP CONTROL FIELDS OUE TO ALTERED CATA" 


the input specifications contain one of the following: 
controt fields to be sorted in descending order 
- control fields defined to be of signed type 
- an alternate colttating Sequence 


Any of these conditions wild cause the control fields to 
contain altered data. Controt fields should be dropped froa 
the output file. 


“SIGNED FIELD USED WITH COLLATE - ALPHA ASSUMED" 


iin the current fixed or free format INCLUDE/DELETE statement » 

the type specified is signed» ieee» SAv SNe RSNwe» RSA» P or Ue 
Coilating cannot be performed on a signed field. The type 
witl be changed to unsigned alpha. | 


"SUMMARY FIELD {5 INCONSISTENT" 


The previous SUMMARYDATA field CmEss cotuan 67/7) differs from 

its corresponding SUMMARYDATA fietd in the first record type 

description containing SUMMARYDATA or GVERFLOX fietds C*"FSV" 

coluan 678). Either the outpct record positions or the 
specified literals differ. . | 


"TOO FEW FIXED CARDS" 
A nuasaber was specified in the FIXED statement indicating that 


number of fixed format records would follow. An END~OF"FILE 
condition was found before that nuaber Has reached. 


| 
i 
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SEQUENCE SPECIFICATIONS 


ALTERNATE COLLATING SEQUENCE 


To change the standard collating sequerces an "S" is coded in 
column 26 of the header specification and “ALTSEQ" ts coded in 
the first stx positions. As many ALTSEQ statements as needed may 
be useds each statement must begin with ALTSEQ and can contain a 
maximua of 96 positions. | 


NOTES Do not use a packed or unpacked factor-1 in an include or 


omit record type specification (P of U in column 8) if the 
alternate collating sequence 15 specified. 


i) ALTSEQ. ts placed in the first stx positions to indicate to 
disk sort that the standard coltating sequence is being 
altered. | | : 


12345 6 


PAULITESIELQH PP e tena gt 


2) The next two positions are Left blank. 


12345678 


RSS EDS aAEARBS EE BO MSM On BEAM BDE BASE BSE OSB enn mS BS ae - ey 


PAUTLITASIEDOQIDibsi tf bobo’ ' bb Cb = blank) 


3) Enter the hex equivalent of the character being taken out of 


normai sequence. 


12345678 9 10° 


PAULETISIETQ! § thint § 1 t t @ t Chn = hex nuasber) 
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4) Enter the hex equivalent of the vatue_ the nase 


5) 


6) 


7) 


8) 


specified in columns 9 and 10 18s to assume in the collating 
sequencee 


12345 67 6 9 10 11 12 


PAULETISTED QI &@ thi ni hl ni t € | Chn = hex number) 


Use as many pairs of 3) and 4) as the numver of characters 


being taken out of normal sequence. 


No spaces are left oetween sets of hex de 


12345678 9 10 11 le 13 14 15 16 


LASLITISIEL QE t tht ni hint hi ni nl nt 


’ 


Further specification lines are used to continues following 
the rules indicated in 1) through 6). 


A doubie asterisk is used in posttions 1 and 2 to indicate 
the end oF the ALTSEQ statementss 


12345 676910 11 12 13 14 15 16 


PATLITISIEGON | os ni hi nt hi ae hi ni 


GAULITISIEI( GI ' ihi ni hi ni ht nl at ni 


PAILITISIEIQ! 1 tht ni ht ni ni niohioni 


iat*#i oii es oe i § 9 ¢ { 


. h 
1 1 08 DE OE OD OE OD OD OS a OE GE 68 OE OH SD OSE OO CHE BSE OOS OP Bet ew 2S Be @ 
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ANEUT ORDER 


Input to indicate use of the aiternate cotfating sequence must be 
in the following order: 


sequence Specifications 
ae Header line 
be ALTSEQ statements 
Ce &t 
de Record type lines as required 
ee Fietd description tines as required 


NOTES: <A character being moved into a sequence position assigned 

| to another character will occupy the same position and 
are considered equal (Csee ALTSEQ Statements» Exampte 1). 
If the characters are not to be equat» the character that 
normatiy occuptes the position must also be soved (see 
ALTSEQ Statementss Example 2). 


ALTSEQ statements can change: 
1. Factor~1 and factore2 
2e Normat and opposite controt fietds 
3e Controt field characters before they are 
replaced or added to by forced fields 


ALTSEQ statements cannot change: 
1. Data fields in records 
2e Forced control fietd characters 


SAMPLE ALISEQ STATEMENTS 


Example 1:2 To change the sequence of one character: 


ALTSEQ ALTSE@ 40F0 
Statements wk 


Explanation: Blank €40) is moved to the position in the 
cottating sequence occupied by zero (FO)... 
Blanks and zeros are» therefore» consider= 
ed equal. 
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Exaaple 2: To change the sequence of several characters: 


ALTSEQ ALTSEQ SBCS8CBCIC9D1 
Stateszents kt : 


Exptanation: 58C8 moves $ (5B) to the position occurpied 
CB8C9 moves H (CB) to the position occupied 
C9D1 moves I (C9) to the position occupied 
The $ is inserted between G and H as follows: 
AsBeoCeoDoErFf »G»e$eHei CI and J occupy the 
Same position) | 


na aS gy Mi at rhe i nn ei 
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| FORCED-FIELD SORTING PROCECURES 


Defining a Conditional Force Character 
1- Fidtt in columns 1°6 as they would normatty be filled tne 
2e Put an F in coluan 7. 


3- Define the position of the control field for the input record 
in columns 13-164 | 


he pacer che character that is to be replaced in column 17. 


Se Enter the character that ts to replace it in column 18. 


Defining a Force-ALl Character 
1. Fitt in columns 1°76 as they would rormally be filled in. 
Ze Put an F in coluan 7. 


3. Put the character which replaces the control field in column 
18. , 


4. Enter the character that is to be replaced in column 19. 
CThe character entered itn colugn 19 informs the disk sort 
that the line is a continuation of the preceding Line.) 


5 Leave cotumns 9717 blank. 


If a bsrcenait tine is not placed after a Sandee onal force tine 
and the sort program does not find the specified characters in 


the control field of the input record» the prograsr 


& Replaces the control field character with aFFa if ascending 
 gequence is specified in the header Line. | 


* Replaces the control field character with 2002 if seston ting 


sequence is specified in the header line. 


Defining an Unconditional Force Character 


le Fitl in colugns 1°6 as they would normally be filled in. 


2e Put an F in column 7. 


; 7 B-2 
BURROUGHS CORPORATION |. COMPANY CONFICENTIAL 
COMPUTER SYSTEMS GROUP B1800/B1700 SORT/UTILITY 
SANTA BARBARA PLANT | | P.Se 2222 2532 (C) 


Ze Put the character which reptaces the control field in columns. 
18. 


4-2 ‘Leave columns 9°17 blank. 


Specifyiog an Overflow Indicator Field 

le Fill in columns 176 as they would normatly be filled in. 

@e Put an 5 in. cotuan Ve 

3. Put a Vin column 8. 

Le eater: a character in cotumn 17 if replacement with an 
asterisk (*) is not desired. If overflow occurs in = any 


Summary data field in the records the initial vatue of the 
overflow field is reptaced by the character in column 17. 


Se Enter a character in column 18 If none of the Summary data 
 f1eids overftows the overfton field with contain the 
character specified in cotumn 18. 


NOTE: Only one overflow indicator may De defined for ail 
record types. 
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SAMPLE JOB ONE 


<header type> CONTROL 10 
<record type> | ~=iNCLUDE (69 LEG 40 6 DIGIT) 
<field type> KEY (7 4 A UA) (1 6 A UA) 


DATA C11 14 UA) C28 2 UAD C30 5) 
(46 5) (69 6) (81 6) (87 5) 
(92 5) (75 6) 


SAMPLE JOf TWO 


<header type> TAGSORT 
CONTROL 10 
<field type> KEY €7 4 UA) C1 6 DIGIT) 


SAMPLE JOE THREE 


<header type> |‘ OROP_- CONTROL 
CONTROL 7 
<record type> INCLUDE (7 LEG "0130" 4 DIGIT) AND 


C7 GEQ "0126" 4 DIGIT) 


<field type> KEY €7 4 UA) (97 3 0D DIGIT) 
| 7 DATA (1 6) (7 4) (97 3) €106 6) 


SAMPLE JOB EguR 


<header type> CONTROL 13 
«record type> «—S—- INCLUDE (1 EQL "R" UA ) 
<field type>  FORCEKEY ("1") 


KEY €6 6 DIGIT) 
DATA €2 4) €12 5) €17 6) €23 5) 


«record type> — INCLUDE (1 EQL "i™ UA) 


<tield type> FORCEKEY ("2") 
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<record type> 


<field type> 


SAMPLE JOB FIVE — 


<header type> 


<record type> 


<field type> 


‘SAMPLE JOE SIX 


<header type> 


<record type> 


<field type>. 


SAMPLE JOE SEVEN 


<header type> 


<record type>. 


<field type> 
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KEY €2 6 DIGIT) (28 6 DIGIT) 
DATA (8 5) €13 7) €20 8) (34 1) (35 5) 


INCLUDE (1 EQL “A™ UA) 
FORCEKEY ("3") 


KEY (2.6 DIGIT) | 
DATA (8 1) €9 5) C24 4) C18 6) 


SUMMARIZE 


CONTROL 6 
INCLUDE (1 EQL "A" UA) 


KEY €2 6 UA) 


SUMMARIZE 
CONTROL 7 


INCLUDE (1 Eat "I" UA) 


KEY (13 7 UA) 
FORCEDATA (™ ™) Cran) 


~SUMMARYDATA (40 3 DIGIT) 


FORCECATA (C® *) ( 3") 
SUMMARYDATA (43 8 RSA) 
GVERFLOW CX) 


DROP CONTROL 
CONTROL 8 


DELETE €23 EQL "X") 


INCLUDE 


KEY (15 8 RSA) 
DATA C1 23 UA) 
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FILE INVETORY CDISK DEFAULT) INVYROS CTAPE 111 10) INVYR0O3 
| | CTAPE 111 20) INVYRO2 CTAPE 111 10) INVYRO1 
CTAPE 111 10) OUTPUT COISK DEFAULT) 


<header type> 


<record type>. 


<field type> 


SAMPLE JOE NINE 


<header type>. 


<record type> 


<fieid type> 


CONTROL 13 


INCLUDE (7 EQL "0126" 4 DIGIT) AND 

a (87 EQL "00023" 5 DIGIT) OR 
(7 EQkL "0126" 4 DIGIT) AND 
(87 EQL "co0108" 6 DIGIT) OR 
(7 EQ@L "0126" 4 DIGIT ) AND 
(87 EQL "C1120" 5 DIGIT) © 


KEY (104 2 A UA) C87 5S) C1 6 DIGIT) 
DATA (7 4) €97 3) (106 6) 


CONTROL 6 


INCLUDE (44 EQL "#" OTGIT) AND 


(87 LEG "1" RSN) AND <:Disptlacement 
>specified in 
| | sbytes 
(87 GTR "0" RSN) AND zDisplacement 
| >specified in 
sbytes | 
C45 EQL "a" ZONE) AND 
C45 EQL "8" DIGIT) 


KEY (1 6 DIGIT) 


DATA (7 105 UA) 


1s 
hal f 


1s. 


hai f 
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‘DYNAMIC MEMORY USAGE 


Dynamic semory is allocated from two stacks which run together. 
Permanent memory spaces are at tow address Cthe beginning of 
dynamic ememory) locations. Temporary spaces are allocated from 
the Limit register down and each piece has an associated tength 
field af 16 bits. This attows temporary chunks to be returned 


either one at a time in a LIFO manner or alt at oncee Returned 


areas are zero filled. 


Permanent space is used for ID.KEYS» F.KEYS and the collate 
table. Temporary mesory is used for record buffer se» temporary 


constants and alt short duration itemse 


The default size for dynamic memory is 32000 bits and is 


sufficient for most runse Should this prove insufficient» 
however » SORT/UTILITY witt terminate after disptaying the 
message: | 


— NEEDS AT LEAST <X> BITS MURE DYNAMIC MEMORY. 


X is the exact amount of additionat memory required for that one 
specific allocation to succeed. A future run given 32000 #+ X_ 
wid successfully process beyond that jpoint but subsequent 
allocations may halt SORT/UTILITY again. 


Since dynamic memory usage in SORT/UTILITY is dynamic» and pieces 
are returned and retrieved often» no exact figure can be 
calculated for the total required. 


LINKED DATA STRUCTURES © 


A linked list structure is created internatly by SORT/UTILITY and 


stored in permanent dynamic memory.s It is created from the input 
specifications and used in processing the work and output files. 
The Linked list is made up of *KEYS*. There are two types of 
keys: the [D.-KEY which holds aal information needed to describe 


an INCLUDE/DELETE type statement and the FeKEY which hotds att 


infor sation needed to describe a field type statement Ci.e.r KEY» 


 FORCEKEYs DATA» FORCEDATA> SUMMARYDATA> or OVERFLOW). 


There are various chains running through the tftinked list (Csee 
figure Dri). The primary chain links are IDeKEY and F.KEY 


entries. The head of this chain is calted ID.#HEAD. IDeHEAD 


points to the first ITO.KEY- Ail ID.KEY's are Linked together by 
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the field ID-LINK. The ID.FeLINK field of each ID.KEY Links 


 FeKEYS to their associated ID-KEY's. That is» all ID-KEY's 


describing INCLUDE/DELETE statements of the same record type have 
the same IDeFeLINK pointer. This IDeFeLINK pointer points to the 
first FeKEY describing a field statement for this record type. 
FeKEY's of a record type are Linked by the FeLINK field. A value 
of -1 indicates the end of a tinked List. | | 


The sumsary keys chain ts initiatly pointed to by the pointer 


SeHEAC. This chain is made up of F.KEY entries describing 
SUMMARYDATA statements of the first record type description 
containing SUMMARYDATA or OVERFLOW stateszents. These are the 
SUMMARYDATA statements that define any summarizing to be 
per formed.. 7 


The CLePTR field points to an FeKEY describing an OVERFLOW 


Statements if there is one. This statement wust atso be defined 
in the first #record type description containing suammar y 
inforrgatione If both SeHEAD and OF-PTR have a vatue of -l» there 
are no SUMMARYDATA or OQVERFLOW statements in the tinput 
specifications. | 


At a minisurs there will be one IDeKEY and one F.KEY entry in 
this tlinked ttst structure. One extra IOD-KEY entry witt exist 


which witt not represent an INCLUDE/DELETE statement» untess the 


fast INCLUDE/DELETE was an INCLUDE ALL statement or an isplied 


INCLUDE ALL situation existed. In other words» if there are no 
INCLUDE or DELETE statements in the input specificationss there 


wiifl be only one ID.KEY entry tn the tinked List representing an 
INCLUDE ALL. If the tast INCLUDE/DELETE was an INCLUDE ALL 
statements the number of I0D.KEY entries will equal the number of 


INCLUDE/DELETE statements. In alt other cases there will be one 


more ID-KEY entry than INCLUDE/DELETE statements» and the extra 
will be the tast ID.KEY. | ) 


The tast IDeKEY entry of the tist witt onty potnt to F.KEY 


entries (by way of its ID.~F.LINK field) if it represents an 


INCLUCE ALL situation or statement. 
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Figure D-1: INTERNAL KEYS CHAIN AFTER SYNTAX PHASE 
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TAGSORT 


Work records are built with keys on the right and retative record 
pointers on. the left. Relative record pointers are eight decimal 
digits» 4 bytesa tong. SORT is catted with the work file as 


input and the output file as output. The keys are truncated when 
the output file is written because its record size is four 


characterse No output pass is done. 


RECORE 


Work records are built with input file number >» relative record 
pointer» record type key pointers and keyse SORT is called with 
input and output file of WORK. An output pass uses inforsgation 
fron the work records to create the output records by 
tagsearching the original input records. 7 


SUMMARY 


Processing is the same as a record sort except during the output 
passe The key of each work record is compared to the next. When 
they are equal» the summary fields are added together. An output 
record is written when they are not equal. 
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FILE ATTRIBUTE ASSIGNMENT PRECECENCE 


File equates specified at executior time witt override file 
Statexent specifications for the following attributes: 


RECORD SIZE | 
RECORDS PER BLOCK 
BLOCKS PER AREA 

AREAS 

NAME 

HARDWARE 


The fite statement will override for the following attributes: 


CODE TYPE. 
PARITY 
MULTI PACK 


Missing attributes» those not specified py file equates or a FILE. 
statesents will be given SOL defaults unless the file is on disk. 
If the fiie is on disk» the attributes will coae from the disk 
file header. The SDL defaults will be taken from the FPB of a 
file with the internal name of "DEFAULT". 


Output files specified as DISK DEFAULT. will get default 
attributes from the first input file if it resides on disk. 
Utherwise» assignment rules are identical to those described 
above. 7 | | | 


If the file is to be inctuded in SORT/UTILITY*s input data» 
either the name fields» FBP.NAMES» or the hardware field» 
FPB.HOWR» must be altered in an input file*s FP. 


a a la ei 
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RESTART PROCEDURES 
If the Statement  “RESTART™ is specified in the input 
specifications» the SORT/UTILITY run will be made "restartable"™. 
This ailows the user to restart the job at various points in case 
of an abnormal terminate. A SORT/UTILITY run is restarted by 
specifying "RESTART" fottowed by the abdnormatly terminated 
SORT/UTILITY*s job nunber. : 3 


A SORT/UTILITY run is divided as follows? 


FIRST PASS —sO SYNTAX ANALYSIS 7 
INPUT FILE VERIFICATIONS 
GENERATION OF KORK FILE 


SORT 


SECOND PASSS3 GENERATION OF OUTPUT FILE 
Ctast pass) 


If the SORT/UTILITY run has been specified as restartable» and 
the program abnormally terminates before the end of the first 


passes the restarted rep wiit resume at the beginning of the first 
passe 


If the job abnormally terminates vartite the SORT phases the 
restarted job wilt RESTART the SORT phase» skipping everything in 
the first pass except the syntax analysis. 


If the SORT/UTILITY run abnormally terminates in the Last pass» 
the restarted job will resume at the beginning of the last pass» 


skipping everything before that except the syntax analysise The 
syntax analysis will always be performed. 


When a job is being restarted» it is also being made restartable. 
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‘SWO=1 


SW1=1 


SW2=1 


PROGRAM SWITCHES 


Causes the specifications Cusually a CARDS file) to be 
read from the accept queuee A blank accept terminates the 


If errors are detected in the specifications» they will be 
written to the ERROR.LINE file. 


This sain’ dies makes the SORT restartables and» if 
the tast 24 bits of the program switches are not zerop a 


restart of the specified job number is effected. This 


cannot be used when debugging. 


Debugging _— | 
Trace (print) att of the conditionat halts to the LINE 
file. 


Print atl tokens found by GET.TOKEN. 


Print contents of keys and FPB*s when they are accessed. 


Attows hatting at a Sequence nusber specified in the 


rightmost 24 bits of atl the program switchese 


Cosbinations of values may be used. 
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COMPILING 


SORT/UTILITY specifications can be corapiled tn the same manner as 
the SORT programe The odject file generated can then be executed 
to initiate a SORT/UTILITY run using the compited specifications. 
The statement Peaene? ts: 


~{lt) 
co <object file nase> CWITHI SORTER CSA] 3 
CSY¥] 


FI CAROS NAME <input specifications Fite name> 3 


NOTES: 2. Brackets» (1» denote an optional iten. 


2e See the Software Qperational Guide syntax for the 
COMPILE statement. 


File equates can be used with the generated object file to alter 
input or output file specifications. Program switches can be 
used to specify RESTART when using this ccompiting method (Csee 
Appendix H on Program Switches). | | 
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